agentleFS
Aidas-devAidas-dev/k8s-agent-skills/skills/talosctl/SKILL.md

talosctl

Skill4 starsChanged 5 months agoMITView on GitHub

Talos Linux CLI operations — cluster lifecycle, upgrades, reboots, node-level diagnosis, etcd maintenance, and troubleshooting with talosctl.

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈0

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Only after the user explicitly confirms the dry-run output, run without --dry-run.

    line 20

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

talosctl — CLI Operations

For machine config YAML (documents, patching) see talosconfig. For Terraform provider see talos-terraform.

⚠️ Configuration Changes Require Dry-Run + Verification

Every apply-config and patch machineconfig MUST be dry-run first, and the user MUST review/approve the output before anything is applied:

# Dry-run first — always
talosctl patch machineconfig --nodes <ip> --patch @patch.yaml --dry-run
talosctl apply-config --nodes <ip> --file config.yaml --dry-run

Only after the user explicitly confirms the dry-run output, run without --dry-run.

⚠️ apply-config Needs the FULL Config File

talosctl apply-config --file <config> replaces the node's entire machine configuration with the contents of <config>. It is NOT a patch tool — providing a partial YAML wipes all unspecified settings.

  • Full-file changes (install, network rewrite, secrets rotation) → talosctl apply-config --file <full-config.yaml>
  • Targeted changes (one field) → talosctl patch machineconfig --patch @patch.yaml
  • Get the current full config first: talosctl get machineconfig v1alpha1 -o yaml

CLI Quick Reference

Cluster Lifecycle

CommandPurpose
talosctl gen config <name> <endpoint> --with-secrets secrets.yamlGenerate cluster configs (full config files)
talosctl gen secrets --output-file secrets.yamlGenerate secrets bundle
talosctl apply-config --nodes <ip> --file config.yaml --insecureApply FULL config to new node
talosctl bootstrap --nodes <ip>Bootstrap etcd (once, first CP only)
talosctl kubeconfig --nodes <ip> --forceGet admin kubeconfig (overwrite existing)
talosctl health --nodes <cps> --wait-timeout=10mCheck cluster health
talosctl versionShow client + server versions

Maintenance

CommandPurpose
talosctl upgrade --image ghcr.io/siderolabs/installer:v1.13.8 --reboot-mode=defaultUpgrade Talos OS (drains node by default)
talosctl upgrade --no-rebootUpgrade, defer reboot (replaces deprecated --stage)
talosctl upgrade --drain=falseUpgrade without draining (use with care)
talosctl upgrade-k8s --to v1.36.2 --dry-runUpgrade Kubernetes (dry-run first)
talosctl upgrade-k8s --to v1.36.2Upgrade Kubernetes
talosctl rollback --nodes <ip>Rollback Talos to previous install
talosctl reboot --mode=defaultReboot node (default/force/powercycle)
talosctl reset --graceful --rebootReset node (removes from cluster)
talosctl shutdownShutdown node (cordon/drain first, --force to skip)

Config Changes

CommandPurpose
talosctl patch machineconfig --nodes <ip> --patch @patch.yaml --dry-runPatch specific fields (DRY-RUN FIRST)
talosctl patch machineconfig --nodes <ip> --patch-file patch.yamlPatch from file
talosctl apply-config --nodes <ip> --file <FULL-config.yaml> --dry-runReplace FULL config (DRY-RUN FIRST)
talosctl apply-config --nodes <ip> --file cfg.yaml -p @patch.yamlApply full config + on-the-fly patches
talosctl get machineconfig v1alpha1 -o yamlGet current full config (with ID)
talosctl edit machineconfigEdit config in default editor
talosctl validate --mode metal --strict config.yamlValidate config offline (metal/cloud/container)

Patch flags: -p, --patch stringArray (inline or @file), --patch-file. Apply modes: -m, --mode auto|no-reboot|reboot|staged|try.

Node-Level Diagnosis

Extensive per-node troubleshooting. Add --nodes <ip> to every command (or -n for multiple).

Services & Logs

talosctl service                       # all services + state
talosctl service <id>                  # single service status
talosctl service <id> start|stop|restart
talosctl logs <service> --tail 100     # service logs (kubelet, etcd, containerd, etc.)
talosctl logs <service> -f             # follow logs
talosctl restart <id>                  # restart a process (e.g. kubelet)
talosctl dmesg                         # kernel logs
talosctl dmesg -f                      # follow kernel logs

Complete Resource Reference (v1.13.7 registry)

talosctl get <type> is the primary read API — Talos models ALL system state as resources. All 167 types (165 machinery + 2 COSI meta) below. Full names are <Name>.<suffix>; aliases are interchangeable. Not every type populates on every node: control-plane types (etcd, secrets, k8s controlplane ns) only on CP nodes, kubespan only when enabled, secrets/* are sensitive (talosctl redacts). This list is version-bound — run talosctl get rd to discover types added by extensions.

talosctl get rd                        # list ALL available resource types on this node
talosctl get <type> -o yaml            # full spec for any resource
talosctl get <type> <id>               # single resource by ID
talosctl get <type> -w                 # watch changes

Common shortcuts: mc/machineconfig, rd, links, routes, addresses, resolvers, hostname, disks, cpu, members, services/svc, nodename, timestatus, mounts.

meta (available on every node)

TypeAliasesShows
ResourceDefinitionsrd, rds, resourcedefinitions, api-resourcesEvery registered type: aliases, print columns
Namespacesns, namespacesAll namespaces in runtime state

block / storage (ns runtime)

TypeAliasesShows
Disksdisk, disksPhysical disks: size, model, serial, transport, WWID
BlockDevicesblockdevice, blockdevicesBlock devices (partitions): type, partition name
DiscoveredVolumesdiscoveredvolume, discoveredvolumesVolumes found on disks (install/bootstrap)
VolumeStatusesvolumestatus, volumestatusesVolume state: type, phase, location, size
VolumeConfigsvolumeconfig, volumeconfigsDesired volume configuration
VolumeLifecyclesvolumelifecycle, volumelifecyclesVolume lifecycle signals
SystemDiskssystemdisk, systemdisksWhich disk is the Talos system disk
MountStatuses (block)mountstatus, mountstatusesBlock-layer mounts: source, target, fs, volume
MountRequestsmountrequest, mountrequestsPending mount requests
VolumeMountRequestsvolumemountrequest, volumemountrequestsVolume mount requests
VolumeMountStatusesvolumemountstatus, volumemountstatusesVolume mount state
SwapStatusesswap, swaps, swapstatus, swapstatusesSwap devices: size, used, priority
BlockSymlinksblocksymlink, blocksymlinksSymlinks into block device tree
UserDiskConfigStatusesuserdiskconfigstatus, userdiskconfigstatusesUser-disk config readiness
ZswapStatuseszswapstatus, zswapstatuseszswap stats: size, stored, written back
DiscoveryRefreshRequestsdiscoveryrefreshrequest, discoveryrefreshrequestsRe-run disk/volume discovery
DiscoveryRefreshStatusesdiscoveryrefreshstatus, discoveryrefreshstatusesDiscovery refresh status

cluster (ns cluster)

TypeAliasesShows
Identitiesidentity, identitiesNode cluster identity (ID)
Membersmember, membersCluster members: hostname, type, OS, addresses
Affiliatesaffiliate, affiliatesDiscovered affiliates / KubeSpan peers
Infosinfo, infosCluster ID, cluster name
DiscoveryConfigsdiscoveryconfig, discoveryconfigsDiscovery configuration

config (ns config)

TypeAliasesShows
MachineConfigsmc, mcs, machineconfig, machineconfigsActive/persistent machine config YAML
MachineTypesmachinetype, machinetypes, mt, mtscontrolplane vs worker

cri (ns cri)

TypeAliasesShows
ImageCacheConfigsimagecacheconfig, imagecacheconfigsCRI image cache status
SeccompProfilesseccompprofile, seccompprofilesSeccomp profiles
RegistryConfigsregistryconfig, registryconfigs, registriesContainer registry configuration

etcd (ns etcd)

TypeAliasesShows
EtcdSpecsetcdspec, etcdspecsetcd config: name, addresses
EtcdMembersetcdmember, etcdmembersetcd cluster members: member ID
EtcdConfigsetcdconfig, etcdconfigsetcd image config
PKIStatusespkistatus, pkistatusesetcd PKI readiness: ready, secrets version

files (ns files)

TypeAliasesShows
EtcFileSpecsetcfilespec, etcfilespecsDesired /etc files
EtcFileStatusesetcfilestatus, etcfilestatusesApplied /etc file state

hardware (ns hardware)

TypeAliasesShows
Processorscpu, cpus, processor, processorsCPU topology and features
MemoryModulesram, memorymodule, memorymodulesRAM modules: manufacturer, model, size
PCIDevicesdevice, devices, pcidevice, pcidevicesPCI devices: class, vendor, product
SystemInformationssysteminformation, systeminformationsDMI: vendor, model, UUID, firmware
PCRStatusespcrstatus, pcrstatusesTPM PCR status
PCIDriverRebindConfigspcidriverrebindconfig, pcidriverrebindconfigsRequested PCI driver rebinds
PCIDriverRebindStatusespcidriverrebinds, pcidriverrebindstatus, pcidriverrebindstatusesPCI driver rebind results

k8s node-local (ns k8s)

TypeAliasesShows
Nodenamesnodename, nodename...Kubernetes node name
NodeStatusesnodestatus, nodestatusesNode ready, unschedulable
NodeIPsnodeip, nodeipsResolved node IPs
NodeIPConfigsnodeipconfig, nodeipconfigsNode IP selection config
KubeletConfigskubeletconfig, kubeletconfigsDesired kubelet configuration
KubeletSpecskubeletspec, kubeletspecsKubelet image, args
KubeletLifecycleskubeletlifecycle, kubeletlifecyclesKubelet lifecycle flags
KubeletKubeconfigskubeletkubeconfig, kubeletkubeconfigsKubelet kubeconfig hash
StaticPodsstaticpod, staticpodsStatic pod definitions
StaticPodStatusespodstatus, staticpodstatus, staticpodstatusesStatic pod readiness
StaticPodServerStatusesstaticpodserverstatus, staticpodserverstatusesStatic pod server status
NodeLabelSpecsnodelabelspec, nodelabelspecsLabels to apply to node
NodeTaintSpecsnodetaintspec, nodetaintspecsTaints to apply to node
NodeAnnotationSpecsnodeannotationspec, nodeannotationspecsAnnotations to apply to node
NodeCordonedSpecsnodecordonedspec, nodecordonedspecsNode cordon state
KubePrismConfigskubeprismconfig, kubeprismconfigsKubePrism LB config
KubePrismEndpointskubeprismendpoint, kubeprismendpointsKubePrism backend endpoints
KubePrismStatuseskubeprismstatus, kubeprismstatusesKubePrism health data

k8s control plane (ns controlplane)

TypeAliasesShows
Endpointsendpoint, endpointsAPI server endpoints
Manifestsmanifest, manifestsRendered control-plane manifests
ManifestStatusesmanifeststatus, manifeststatusesManifest apply status
BootstrapManifestsConfigsbootstrapmanifestsconfig, bootstrapmanifestsconfigsBootstrap manifests config
ExtraManifestsConfigsextramanifestsconfig, extramanifestsconfigsExtra manifest URLs/contents
ConfigStatusesconfigstatus, configstatusesKubeconfig readiness
SecretStatusessecretstatus, secretstatusesKubernetes secrets readiness
APIServerConfigsapiserverconfig, apiserverconfigskube-apiserver config
ControllerManagerConfigscontrollermanagerconfig, controllermanagerconfigskube-controller-manager config
SchedulerConfigsschedulerconfig, schedulerconfigskube-scheduler config
AdmissionControlConfigsadmissioncontrolconfig, admissioncontrolconfigsAdmission control plugin config
AuditPolicyConfigsauditpolicyconfig, auditpolicyconfigsAudit policy config
AuthorizationConfigsauthorizationconfig, authorizationconfigsAuthorization config

kubeaccess (ns config)

TypeAliasesShows
KubernetesAccessConfigskubernetesaccessconfig, kubernetesaccessconfigsAPI access: roles, namespaces

kubespan

TypeAliasesShows
KubeSpanConfigskubespanconfig, kubespanconfigsKubeSpan configuration
KubeSpanIdentitieskubespanidentity, kubespanidentitiesNode identity: address, pubkey
KubeSpanEndpointskubespanendpoint, kubespanendpointsWireGuard endpoints
KubeSpanPeerSpecskubespanpeerspec, kubespanpeerspecsDesired peers
KubeSpanPeerStatuseskubespanpeerstatus, kubespanpeerstatusesPeer state: endpoint, RX, TX

network (ns network)

TypeAliasesShows
LinkStatuseslink, links, linkstatus, linkstatusesNetwork interfaces: type, kind, MAC, oper state
LinkSpecslinkspec, linkspecsDesired link config
LinkRefresheslinkrefresh, linkrefreshesRefresh link state signal
LinkAliasSpecslinkaliasspec, linkaliasspecsDesired interface alias
EthernetStatusesethtool, ethernetstatus, ethernetstatusesEthtool info: link, speed
EthernetSpecsethernetspec, ethernetspecsDesired ethtool settings
AddressStatusesaddress, addresses, addressstatus, addressstatusesIP addresses
AddressSpecsaddressspec, addressspecsDesired addresses
HardwareAddresseshardwareaddress, hardwareaddressesDesired MAC addresses
RouteStatusesroute, routes, routestatus, routestatusesRoutes: destination, gateway, link
RouteSpecsroutespec, routespecsDesired routes
RoutingRuleStatusesroutingrule, routingrules, routingrulestatus, routingrulestatusesPolicy routing rules
RoutingRuleSpecsroutingrulespec, routingrulespecsDesired routing rules
ResolverStatusesresolver, resolvers, resolverstatus, resolverstatusesDNS resolvers, search domains
ResolverSpecsresolverspec, resolverspecsDesired resolvers
HostnameStatuseshostname, hostnamestatus, hostnamestatusesHostname + domainname
HostnameSpecshostnamespec, hostnamespecsDesired hostname
TimeServerStatusestimeserver, timeservers, timeserverstatus, timeserverstatusesNTP servers in use
TimeServerSpecstimeserverspec, timeserverspecsDesired NTP servers
NodeAddressesnodeaddress, nodeaddressesNode addresses + sort algorithm
NodeAddressFiltersnodeaddressfilter, nodeaddressfiltersInclude/exclude subnet filters
NodeAddressSortAlgorithmsnodeaddresssortalgorithm, nodeaddresssortalgorithmsAddress sort algorithm
NfTablesChainschain, chains, nftableschain, nftableschainsnftables chains: type, hook, priority
DNSUpstreamsdnsupstream, dnsupstreamsDNS upstream resolvers: healthy
DNSResolveCachesdnsresolvecache, dnsresolvecachesHost DNS resolve cache
HostDNSConfigshostdnsconfig, hostdnsconfigsHost DNS config: enabled
ProbeStatusesprobe, probes, probestatus, probestatusesConnectivity probe results
ProbeSpecsprobespec, probespecsDesired probes
OperatorSpecsoperatorspec, operatorspecsNetwork operators (DHCP, VIP)
PlatformConfigsplatformconfig, platformconfigsCloud platform network config
DeviceConfigSpecsdeviceconfigspec, deviceconfigspecsNetwork device config
NetworkStatusesnetstatus, netstatuses, networkstatus, networkstatusesOverall network status

perf (ns perf)

TypeAliasesShows
CPUStatscpustat, cpustatsLast CPU stats: user, system
MemoryStatsmemorystat, memorystatsLast memory stats: used, total

runtime (ns runtime)

TypeAliasesShows
MachineStatusesmachinestatus, machinestatusesMachine lifecycle: stage, ready
MachineResetSignalsmachineresetsignal, machineresetsignalsReset-in-progress signal
Versionsversion, versionsTalos version status
PlatformMetadatasplatformmetadata, platformmetadatasCloud platform metadata
KernelCmdlinescmdline, kernelcmdline, kernelcmdlinesKernel command line
KernelParamSpecskernelparamspec, kernelparamspecsDesired kernel params/sysctls
KernelParamDefaultSpecskernelparamdefaultspec, kernelparamdefaultspecsDefault kernel params
KernelParamStatusessysctls, kernelparams, kernelparameters, kernelparamstatus, kernelparamstatusesApplied sysctl state
KernelModuleSpecskernelmodulespec, kernelmodulespecsKernel modules to load
LoadedKernelModulesmodule, modules, loadedkernelmodule, loadedkernelmodulesLoaded kernel modules
MetaKeysmeta, metakey, metakeysMETA partition key/value pairs
MetaLoadsmetaload, metaloadsMETA loaded marker
UniqueMachineTokensuniquemachinetoken, uniquemachinetokensUnique machine token
Environmentsenv, environment, environmentsEnvironment variables
MountStatuses (runtime)mounts, mountstatus, mountstatusesRuntime mounts
ServicePIDsservicepid, servicepidsService → PID mapping
KmsgLogConfigskmsglogconfig, kmsglogconfigsKernel log streaming config
OOMActionsoomaction, oomactionsOOM action records
BootedEntriesbootedentry, bootedentriesBooted bootloader entry
Diagnosticsdiagnostic, diagnosticsDiagnostic warnings
SecurityStatessecuritystate, securitystatesSecureboot, UKI, SELinux state
SBOMItemssbomitem, sbomitemsSBOM entries
ExtensionStatusesextensions, extensionstatus, extensionstatusesInstalled system extensions
ExtensionServiceConfigsextensionserviceconfig, extensionserviceconfigsExtension service config
ExtensionServiceConfigStatusesextensionserviceconfigstatus, extensionserviceconfigstatusesExtension service config status
MaintenanceServiceConfigsmaintenanceserviceconfig, maintenanceserviceconfigsMaintenance service config
MaintenanceServiceRequestsmaintenanceservicerequest, maintenanceservicerequestsMaintenance service request
APIServiceConfigsapiserviceconfig, apiserviceconfigsTalos API service config
EventSinkConfigseventsinkconfig, eventsinkconfigsEvent sink (log shipping) config
WatchdogTimerConfigswatchdogtimerconfig, watchdogtimerconfigsWatchdog config: device, timeout
WatchdogTimerStatuseswatchdogtimerstatus, watchdogtimerstatusesWatchdog status
DevicesStatusesdevicesstatus, devicesstatusesHardware devices readiness

secrets (ns secrets, control-plane, sensitive)

TypeAliasesShows
OSRootSecretsosrootsecret, osrootsecretsOS root CA & certs
KubernetesRootSecretskubernetesrootsecret, kubernetesrootsecretsK8s root CA & SA keys
KubernetesSecretskubernetessecret, kubernetessecretsK8s cert bundle
KubernetesDynamicCertskubernetesdynamiccert, kubernetesdynamiccertsDynamically issued K8s certs
KubeletSecretskubeletsecret, kubeletsecretsKubelet client cert bundle
EtcdRootSecretsetcdrootsecret, etcdrootsecretsetcd root CA & certs
EtcdSecretsetcdsecret, etcdsecretsetcd server/peer certs
TrustdCertificatestrustdcertificate, trustdcertificatesTrustd cert bundle
ApiCertificatesapicertificate, apicertificatesTalos API cert bundle
MaintenanceRootSecretsmaintenancerootsecret, maintenancerootsecretsMaintenance-mode root secrets
CertSANscertsan, certsansSANs for API certs
EncryptionSaltsencryptionsalt, encryptionsaltsEncryption salt for secrets

security (ns security)

TypeAliasesShows
TUFTrustedRootstuftrustedroot, tuftrustedrootsTUF trusted root refresh
ImageVerificationRulesimageverificationrule, imageverificationrulesImage verification policy

siderolink (ns config)

TypeAliasesShows
SiderolinkConfigssiderolinkconfig, siderolinkconfigsSideroLink config
SiderolinkTunnelssiderolinktunnel, siderolinktunnelsSideroLink tunnel state
SiderolinkStatusessiderolinkstatus, siderolinkstatusesSideroLink connection status

time (ns runtime)

TypeAliasesShows
TimeStatusestimestatus, timestatusesNTP sync status
AdjtimeStatusesadjtimestatus, adjtimestatusesadjtimex state: offset, status

v1alpha1 (ns runtime)

TypeAliasesShows
Servicessvc, service, servicesTalos services: running, healthy
AcquireConfigSpecsacquireconfigspec, acquireconfigspecsConfig acquisition signal
AcquireConfigStatusesacquireconfigstatus, acquireconfigstatusesConfig acquired; boot proceeds

System Inspection

CommandPurpose
talosctl containersList system containers (-k for K8s namespace)
talosctl processesList running processes (alias: ps)
talosctl statsContainer stats (CPU/mem per container)
talosctl memoryMemory usage (alias: free)
talosctl cgroups --preset memorycgroupv2 usage (cpu/cpuset/io/memory/process/psi/swap)
talosctl mountsMount points
talosctl list /varDirectory listing (alias: ls)
talosctl read /pathRead a file (alias: cat)
talosctl usage /varDisk usage (alias: du)
talosctl copy /path .Copy data out of node
talosctl image listImages in container runtime
talosctl image pull <ref>Pull image into node
talosctl time --check <ntp-server>Server time + NTP check (--check server form)
talosctl eventsStream runtime events (--duration 1h for history)
talosctl inspect dependenciesController-resource dependency graph
talosctl meta writeWrite META partition keys

Network Diagnosis

talosctl netstat -t --listening        # TCP listening sockets (host)
talosctl netstat -a                    # all socket states
talosctl netstat -k                    # sockets used by K8s pods
talosctl netstat <namespace>/<pod>     # specific pod's connections
talosctl pcap -i eth0                  # live packet capture (tcpdump alias)
talosctl pcap -i eth0 --output file.pcap

Diagnostics & Debug

CommandPurpose
talosctl dashboardReal-time cluster dashboard
talosctl supportDump full debug archive (logs, configs, resources)
talosctl debugRun a debug container on node
talosctl versionVersion info (client + node)
talosctl conformance kubernetesRun K8s conformance tests

etcd

CommandPurpose
talosctl etcd membersList etcd cluster members
talosctl etcd statusetcd cluster member status
talosctl etcd alarm listCheck etcd alarms
talosctl etcd alarm disarmClear no-space alarms
talosctl etcd snapshot snapshot.dbBackup etcd
talosctl etcd defrag --nodes <ip>Defrag etcd database
talosctl etcd forfeit-leadershipMove leader for maintenance
talosctl etcd remove-member <member>Remove member from cluster
talosctl etcd leaveMake node leave etcd cluster

Apply Modes

ModeBehavior
auto (default)Immediate apply, reboot if needed
no-rebootApply without reboot
rebootAlways reboot to apply
stagedApply on next reboot
tryApply, rollback after timeout if not confirmed (default 1m)

Reboot Modes

ModeBehavior
defaultNormal reboot via kexec
powercycleSkip kexec (cold boot, useful for BMC)
forceSkip graceful teardown (emergency only)

Common Patterns

Bootstrap cluster

talosctl gen secrets --output-file secrets.yaml
talosctl gen config prod https://10.0.1.100:6443 \
  --with-secrets secrets.yaml \
  --config-patch-control-plane @network.yaml
talosctl apply-config --nodes 10.0.1.10 --file controlplane.yaml --insecure
talosctl bootstrap --nodes 10.0.1.10
talosctl apply-config --nodes 10.0.1.11 --file controlplane.yaml
talosctl kubeconfig --nodes 10.0.1.10
kubectl get nodes

Upgrade (rolling CP)

# Sequential CP upgrade with verification
for node in cp1 cp2 cp3; do
  talosctl upgrade --nodes $node --image ghcr.io/siderolabs/installer:v1.13.8
  kubectl wait --for=condition=Ready node/$node --timeout=10m
  talosctl etcd members
  sleep 30
done

Targeted config patch (dry-run first!)

# 1. Dry-run — show what changes WITHOUT applying
talosctl patch machineconfig --nodes cp1 --patch @patch.yaml --dry-run

# 2. After user confirms the diff, apply
talosctl patch machineconfig --nodes cp1 --patch @patch.yaml

Full config replacement (dry-run first!)

# 1. Get current full config
talosctl get machineconfig v1alpha1 --nodes cp1 -o yaml > current.yaml

# 2. Edit, then dry-run the new full config
talosctl apply-config --nodes cp1 --file edited.yaml --dry-run

# 3. After user confirms, apply
talosctl apply-config --nodes cp1 --file edited.yaml

Upgrade Kubernetes

talosctl upgrade-k8s --to v1.36.2 --dry-run
talosctl upgrade-k8s --to v1.36.2

Node troubleshooting workflow

# 1. Services health
talosctl service --nodes <ip>

# 2. Failed service logs
talosctl logs <failing-service> --tail 100 --nodes <ip>

# 3. Kernel issues
talosctl dmesg --nodes <ip>

# 4. Resources (disk/CPU/mem)
talosctl memory --nodes <ip>
talosctl stats --nodes <ip>
talosctl get disks --nodes <ip>           # hardware disk inventory
talosctl get blockdevices --nodes <ip>    # block devices + partitions
talosctl get disks sda -o yaml --nodes <ip>  # single disk detail
talosctl usage /var --nodes <ip>          # filesystem-level usage

# 5. Network
talosctl get links --nodes <ip>
talosctl netstat -t --listening --nodes <ip>

# 6. Full archive for support
talosctl support --nodes <ip>

etcd maintenance

talosctl etcd snapshot /backup/etcd-$(date +%Y%m%d).snapshot
talosctl etcd defrag --nodes cp1
talosctl etcd alarm list
talosctl etcd alarm disarm       # Clear no-space alarms
talosctl etcd forfeit-leadership # Move leader for maintenance

Common Mistakes

  • Bootstrap more than once — Only one talosctl bootstrap per cluster lifetime. Running it again creates split-brain.
  • Losing secrets — Always --with-secrets secrets.yaml during gen config. Without secrets, you cannot add nodes, rotate certs, or recover. Store encrypted in Vault/SOPS.
  • Upgrade all CP simultaneously — Sequential only. etcd needs quorum. One node at a time, verify health between each.
  • talosctl apply-config with a partial file — apply-config REPLACES the whole config. Partial YAML wipes unspecified settings. Use talosctl patch machineconfig for targeted changes.
  • Skipping --dry-run — Every config change must be dry-run first and reviewed by the user before applying.
  • talosctl get disks vs talosctl disks — get disks uses the disks.block.talos.dev resource. talosctl disks is a separate command with different output.
  • --stage/--preserve flags deprecated — Legacy flags in v1.13+, removed in Talos 1.18. Use --no-reboot instead of --stage.
  • Apply config to all nodes at once — For CP changes, use sequential apply with health checks between nodes (etcd quorum).
  • talosctl reset without --graceful=false — By default --graceful=true which cordons/drains and removes from etcd. Set --graceful=false --reboot for hard reset.
  • talosctl get machineconfig without ID — Needs the resource ID: talosctl get machineconfig v1alpha1.
  • Wrong diagnostics commands — interfaces/routes are NOT talosctl commands. Use talosctl get links / talosctl get routes.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.