KubeOne(1)

📦 version 1.12.3, in arch rolling

💅 KubeOne(1) — the mirror-images glow-up

okay so bestie, welcome to the kubeone-mirror-images page of the KubeOne manual (yes, that's KubeOne(1), the whole man page family, and this is its shiniest child) ✨

🌸 NAME 🌸

kubeone-mirror-images — mirror images to another registry 🪞

🎀 SYNOPSIS 🎀

kubeone mirror-images [registry] [flags]

🦋 DESCRIPTION 🦋

so basically: this command mirrors all the images that KubeOne uses over to another registry. it lists the images (control-plane images included, bestie, it doesn't skip those) and then copies them to the target registry you specify. it's giving "pack your bags, we're moving" energy 💖

✨ OPTIONS ✨

  • --dry-run[=false] — only prints the names of the source and destination images, no actual copying. it's a vibe check first, move second 🙈
  • --filter="none" — images list filter, and it's one of [none|base|optional|control-plane], periodt
  • -h, --help[=false] — help for mirror-images. every icon needs its support system 🫶
  • --insecure[=false] — the insecure option, which bypasses TLS certificate verification. lowkey risky, highkey useful sometimes 🔥
  • --kubernetes-versions="" — Kubernetes versions, comma-separated, format: vX.Y[.Z]. yes you can pass more than one, go off 👑

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

these are the ones you get for free from the parent command, no cap:

  • -c, --credentials="" — file to source credentials and secrets from 🔐
  • -d, --debug[=false] — debug output with stacktrace, for when you need the whole lore 😭
  • -l, --log-format="text" — format for logging
  • -m, --manifest="./kubeone.yaml" — path to the KubeOne config
  • -t, --tfjson="" — source for terraform output in JSON. to read from stdin: if the path is a file, its contents will be used; if the path is a dictionary, terraform output -json is executed in this path 🧚
  • -v, --verbose[=false] — verbose output, aka it tells you everything 💀

🌈 EXAMPLE 🌈

# Mirror all images to a target registry
kubeone mirror-images myregistry.com

# Mirror images for a specific Kubernetes versions
kubeone mirror-images --kubernetes-versions=v1.26.0,v1.29.0 --filter=control-plane myregistry.com

ate, honestly 🍓

💜 SEE ALSO 💜

⭐ HISTORY ⭐

8-Feb-2026 — auto generated by spf13/cobra. not me being machine-written and still slaying 💅

ngl bestie, this whole page was auto generated by spf13/cobra back in Feb 2026, so go give the source some love — and that's the whole KubeOne(1) story, Feb 2026 edition 💖✨🎀
📦 where this page comes from