talosctl

talosctl [--nodes nodes] [--endpoints endpoints] command [options]

talosctl is the command-line tool for managing Talos Linux, a minimal and immutable operating system purpose-built for running Kubernetes. It provides complete lifecycle management for Talos nodes, from initial configuration generation through ongoing cluster operations.The gen config command creates machine configuration files for control plane and worker nodes, including certificates and secrets needed for secure cluster communication. The apply-config command pushes these configurations to nodes, and bootstrap initializes the etcd cluster on the first control plane node to start the Kubernetes cluster.For day-to-day operations, talosctl provides a dashboard for monitoring node health and resource usage, services for inspecting running system services, and logs for viewing service output. The kubeconfig command retrieves cluster credentials for use with kubectl. All communication with nodes uses mutual TLS authentication configured through the talosconfig file.

--nodes NODES

Target nodes.

API endpoints.

Single node.

Config file.

~/.talos/config

Default talosconfig file containing cluster endpoints, node addresses, and TLS credentials for authenticating with Talos nodes

Override the default config file location via command-line flag

Environment variable to specify an alternative talosconfig file path

gen config - Generate configsapply-config - Apply to nodebootstrap - Bootstrap etcdkubeconfig - Get kubeconfigdashboard - Node dashboardservices - List serviceslogs - View logs

Talos-specific tool. Nodes must be Talos. API access required.

Talos was created by Sidero Labs as a minimal, immutable Kubernetes OS. talosctl provides complete lifecycle management.

kubectl(1), docker(1)