From 47dd8e25ef14e2bb3193796c6d23a3eb25e4b55f Mon Sep 17 00:00:00 2001 From: Kevin Tijssen Date: Thu, 15 Jan 2026 21:35:25 +0100 Subject: [PATCH 1/4] fix: change all reference command of talosctl image default Signed-off-by: Kevin Tijssen --- .../image-cache-registry-mirror.mdx | 2 +- .../images-container-runtime/image-cache.mdx | 15 ++++++- public/talos/v1.12/reference/cli.mdx | 38 ++++++++++++++++-- .../v1.12/reference/configuration/cli.mdx | 40 +++++++++++++++++-- 4 files changed, 84 insertions(+), 11 deletions(-) diff --git a/public/talos/v1.12/configure-your-talos-cluster/images-container-runtime/image-cache-registry-mirror.mdx b/public/talos/v1.12/configure-your-talos-cluster/images-container-runtime/image-cache-registry-mirror.mdx index 45172c46..b839dae5 100644 --- a/public/talos/v1.12/configure-your-talos-cluster/images-container-runtime/image-cache-registry-mirror.mdx +++ b/public/talos/v1.12/configure-your-talos-cluster/images-container-runtime/image-cache-registry-mirror.mdx @@ -13,7 +13,7 @@ To serve the image cache over HTTPS: First, build a list of images and create the cache. This example builds a minimal Talos image cache. To learn how to create an image cache, see the [Image cache documentation](./image-cache) ```bash -talosctl images default | \ +talosctl images k8s-bundle | \ talosctl images cache-create \ --images=- \ --image-cache-path=/tmp/cache \ diff --git a/public/talos/v1.12/configure-your-talos-cluster/images-container-runtime/image-cache.mdx b/public/talos/v1.12/configure-your-talos-cluster/images-container-runtime/image-cache.mdx index 7a22e095..ce517f01 100644 --- a/public/talos/v1.12/configure-your-talos-cluster/images-container-runtime/image-cache.mdx +++ b/public/talos/v1.12/configure-your-talos-cluster/images-container-runtime/image-cache.mdx @@ -13,13 +13,24 @@ The cache is local to each machine and is automatically managed by Talos when en ## Preparing Image Cache First, build a list of image references that need to be cached. -The `talosctl images default` might be used as a starting point, but it should be customized to include additional images (e.g. custom CNI, workload images, etc.) +The `talosctl images k8s-bundle` might be used as a starting point, but it should be customized to include additional images (e.g. custom CNI, workload images, etc.) ```bash -talosctl images default > images.txt +talosctl images k8s-bundle > images.txt cat extra-images.txt >> images.txt ``` +### AirGapped Environments +If you are preparing for an airgapped environment, you will need to cache the talos images as well. + +Starting with Talos 1.12 you can get a list of images needed from talosctl. + + +{` +talosctl images talos-bundle ${release_v1_12} >> images.txt +`} + + Next, prepare an OCI image which contains all cached images: ```bash diff --git a/public/talos/v1.12/reference/cli.mdx b/public/talos/v1.12/reference/cli.mdx index 95cfa695..639eed36 100644 --- a/public/talos/v1.12/reference/cli.mdx +++ b/public/talos/v1.12/reference/cli.mdx @@ -1830,12 +1830,12 @@ talosctl images default | talosctl images cache-create --image-cache-path=/tmp/t * [talosctl image](#talosctl-image) - Manage CRI container images -## talosctl image default +## talosctl image k8s-bundle -List the default images used by Talos +List the Kubernetes images used by Talos ``` -talosctl image default [flags] +talosctl image k8s-bundle [flags] ``` ### Options @@ -1917,6 +1917,35 @@ talosctl image pull [flags] * [talosctl image](#talosctl-image) - Manage CRI container images +## talosctl image talos-bundle + +List the default images used by Talos + +``` +talosctl image talos-bundle [flags] +``` + +### Options + +``` + -h, --help help for default +``` + +### Options inherited from parent commands + +``` + --cluster string Cluster to connect to if a proxy endpoint is used. + --context string Context to be used in command + -e, --endpoints strings override default endpoints in Talos configuration + --namespace system namespace to use: system (etcd and kubelet images) or `cri` for all Kubernetes workloads (default "cri") + -n, --nodes strings target the specified nodes + --talosconfig string The path to the Talos configuration file. Defaults to 'TALOSCONFIG' env variable if set, otherwise '$HOME/.talos/config' and '/var/run/secrets/talos.dev/config' in order. +``` + +### SEE ALSO + +* [talosctl image](#talosctl-image) - Manage CRI container images + ## talosctl image Manage CRI container images @@ -1942,9 +1971,10 @@ Manage CRI container images * [talosctl](#talosctl) - A CLI for out-of-band management of Kubernetes nodes created by Talos * [talosctl image cache-create](#talosctl-image-cache-create) - Create a cache of images in OCI format into a directory -* [talosctl image default](#talosctl-image-default) - List the default images used by Talos +* [talosctl image k8s-bundle](#talosctl-image-k8s-bundle) - List the Kubernetes images used by Talos * [talosctl image list](#talosctl-image-list) - List CRI images * [talosctl image pull](#talosctl-image-pull) - Pull an image into CRI +* [talosctl image talos-bundle](#talosctl-image-talos-bundle) - List the default images used by Talos ## talosctl inject serviceaccount diff --git a/public/talos/v1.12/reference/configuration/cli.mdx b/public/talos/v1.12/reference/configuration/cli.mdx index b310b9af..3223bc27 100644 --- a/public/talos/v1.12/reference/configuration/cli.mdx +++ b/public/talos/v1.12/reference/configuration/cli.mdx @@ -1986,12 +1986,12 @@ talosctl image cache-serve [flags] * [talosctl image](#talosctl-image) - Manage CRI container images -## talosctl image default +## talosctl image k8s-bundle -List the default images used by Talos +List the Kubernetes images used by Talos ``` -talosctl image default [flags] +talosctl image k8s-bundle [flags] ``` ### Options @@ -2107,6 +2107,37 @@ talosctl image source-bundle {"<"}talos-version{">"} [flags] * [talosctl image](#talosctl-image) - Manage CRI container images +## talosctl image talos-bundle + +List the default images used by Talos + +``` +talosctl image talos-bundle [flags] +``` + +### Options + +``` + -h, --help help for default + --provisioner string include provisioner specific images (default "installer") +``` + +### Options inherited from parent commands + +``` + -c, --cluster string Cluster to connect to if a proxy endpoint is used. + --context string Context to be used in command + -e, --endpoints strings override default endpoints in Talos configuration + --namespace system namespace to use: system (etcd and kubelet images) or `cri` for all Kubernetes workloads (default "cri") + -n, --nodes strings target the specified nodes + --siderov1-keys-dir string The path to the SideroV1 auth PGP keys directory. Defaults to 'SIDEROV1_KEYS_DIR' env variable if set, otherwise '$HOME/.talos/keys'. Only valid for Contexts that use SideroV1 auth. + --talosconfig string The path to the Talos configuration file. Defaults to 'TALOSCONFIG' env variable if set, otherwise '$HOME/.talos/config' and '/var/run/secrets/talos.dev/config' in order. +``` + +### SEE ALSO + +* [talosctl image](#talosctl-image) - Manage CRI container images + ## talosctl image Manage CRI container images @@ -2130,10 +2161,11 @@ Manage CRI container images * [talosctl image cache-cert-gen](#talosctl-image-cache-cert-gen) - Generate TLS certificates and CA patch required for securing image cache to Talos communication * [talosctl image cache-create](#talosctl-image-cache-create) - Create a cache of images in OCI format into a directory * [talosctl image cache-serve](#talosctl-image-cache-serve) - Serve an OCI image cache directory over HTTP(S) as a container registry -* [talosctl image default](#talosctl-image-default) - List the default images used by Talos +* [talosctl image k8s-bundle](#talosctl-image-k8s-bundle) - List the Kubernetes images used by Talos * [talosctl image list](#talosctl-image-list) - List CRI images * [talosctl image pull](#talosctl-image-pull) - Pull an image into CRI * [talosctl image source-bundle](#talosctl-image-source-bundle) - List the source images used for building Talos +* [talosctl image talos-bundle](#talosctl-image-talos-bundle) - List the default images used by Talos ## talosctl inject serviceaccount From c34e6972c54fd12338bdfcd95c012a2552a94219 Mon Sep 17 00:00:00 2001 From: Kevin Tijssen Date: Thu, 15 Jan 2026 21:48:38 +0100 Subject: [PATCH 2/4] fix: updated cli reference Signed-off-by: Kevin Tijssen --- .../images-container-runtime/image-cache.mdx | 6 ++++-- public/talos/v1.12/reference/cli.mdx | 4 ++-- public/talos/v1.12/reference/configuration/cli.mdx | 4 ++-- 3 files changed, 8 insertions(+), 6 deletions(-) diff --git a/public/talos/v1.12/configure-your-talos-cluster/images-container-runtime/image-cache.mdx b/public/talos/v1.12/configure-your-talos-cluster/images-container-runtime/image-cache.mdx index ce517f01..c1a3560f 100644 --- a/public/talos/v1.12/configure-your-talos-cluster/images-container-runtime/image-cache.mdx +++ b/public/talos/v1.12/configure-your-talos-cluster/images-container-runtime/image-cache.mdx @@ -20,8 +20,8 @@ talosctl images k8s-bundle > images.txt cat extra-images.txt >> images.txt ``` -### AirGapped Environments -If you are preparing for an airgapped environment, you will need to cache the talos images as well. +### Air-Gapped Environments +If you are preparing for an air-gapped environment, you will need to cache the talos images as well. Starting with Talos 1.12 you can get a list of images needed from talosctl. @@ -31,6 +31,8 @@ talosctl images talos-bundle ${release_v1_12} >> images.txt `} +or deploy an [Image Factory](../../../../omni/infrastructure-and-extensions/self-hosted/deploy-image-factory-on-prem) to host Talos images internally. + Next, prepare an OCI image which contains all cached images: ```bash diff --git a/public/talos/v1.12/reference/cli.mdx b/public/talos/v1.12/reference/cli.mdx index 639eed36..0c65a17b 100644 --- a/public/talos/v1.12/reference/cli.mdx +++ b/public/talos/v1.12/reference/cli.mdx @@ -1841,7 +1841,7 @@ talosctl image k8s-bundle [flags] ### Options ``` - -h, --help help for default + -h, --help help for k8s-bundle ``` ### Options inherited from parent commands @@ -1928,7 +1928,7 @@ talosctl image talos-bundle [flags] ### Options ``` - -h, --help help for default + -h, --help help for talos-bundle ``` ### Options inherited from parent commands diff --git a/public/talos/v1.12/reference/configuration/cli.mdx b/public/talos/v1.12/reference/configuration/cli.mdx index 3223bc27..56e7a326 100644 --- a/public/talos/v1.12/reference/configuration/cli.mdx +++ b/public/talos/v1.12/reference/configuration/cli.mdx @@ -1997,7 +1997,7 @@ talosctl image k8s-bundle [flags] ### Options ``` - -h, --help help for default + -h, --help help for k8s-bundle --provisioner string include provisioner specific images (default "installer") ``` @@ -2118,7 +2118,7 @@ talosctl image talos-bundle [flags] ### Options ``` - -h, --help help for default + -h, --help help for talos-bundle --provisioner string include provisioner specific images (default "installer") ``` From ed514630fef520597e4715470683a8268bfc95c6 Mon Sep 17 00:00:00 2001 From: Kevin Tijssen Date: Thu, 15 Jan 2026 21:53:36 +0100 Subject: [PATCH 3/4] fix: changed references of talos images default Signed-off-by: Kevin Tijssen --- public/talos/v1.12/reference/cli.mdx | 2 +- public/talos/v1.12/reference/configuration/cli.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/public/talos/v1.12/reference/cli.mdx b/public/talos/v1.12/reference/cli.mdx index 0c65a17b..8baef3a4 100644 --- a/public/talos/v1.12/reference/cli.mdx +++ b/public/talos/v1.12/reference/cli.mdx @@ -1799,7 +1799,7 @@ talosctl image cache-create [flags] talosctl images cache-create --images=ghcr.io/siderolabs/kubelet:v1.33.0 --image-cache-path=/tmp/talos-image-cache Alternatively, stdin can be piped to the command: -talosctl images default | talosctl images cache-create --image-cache-path=/tmp/talos-image-cache --images=- +talosctl images k8s-bundle | talosctl images cache-create --image-cache-path=/tmp/talos-image-cache --images=- ``` diff --git a/public/talos/v1.12/reference/configuration/cli.mdx b/public/talos/v1.12/reference/configuration/cli.mdx index 56e7a326..8ecc2390 100644 --- a/public/talos/v1.12/reference/configuration/cli.mdx +++ b/public/talos/v1.12/reference/configuration/cli.mdx @@ -1914,7 +1914,7 @@ talosctl image cache-create [flags] talosctl images cache-create --images=ghcr.io/siderolabs/kubelet:v1.35.0-alpha.3 --image-cache-path=/tmp/talos-image-cache Alternatively, stdin can be piped to the command: -talosctl images default | talosctl images cache-create --image-cache-path=/tmp/talos-image-cache --images=- +talosctl images k8s-bundle | talosctl images cache-create --image-cache-path=/tmp/talos-image-cache --images=- ``` From 5b7705a9ec390fa7d09743f12e218382a4a7a7d9 Mon Sep 17 00:00:00 2001 From: Kevin Tijssen Date: Thu, 15 Jan 2026 22:50:09 +0100 Subject: [PATCH 4/4] Update public/talos/v1.12/configure-your-talos-cluster/images-container-runtime/image-cache.mdx Co-authored-by: Justin Garrison Signed-off-by: Kevin Tijssen --- .../images-container-runtime/image-cache.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/public/talos/v1.12/configure-your-talos-cluster/images-container-runtime/image-cache.mdx b/public/talos/v1.12/configure-your-talos-cluster/images-container-runtime/image-cache.mdx index c1a3560f..d34a587b 100644 --- a/public/talos/v1.12/configure-your-talos-cluster/images-container-runtime/image-cache.mdx +++ b/public/talos/v1.12/configure-your-talos-cluster/images-container-runtime/image-cache.mdx @@ -32,7 +32,7 @@ talosctl images talos-bundle ${release_v1_12} >> images.txt or deploy an [Image Factory](../../../../omni/infrastructure-and-extensions/self-hosted/deploy-image-factory-on-prem) to host Talos images internally. - +Including all talos-bundle images will significantly increase the size of your installation media. The minimum images to install Talos include the `installer` and `installer-base` images. Next, prepare an OCI image which contains all cached images: ```bash