Version v1.12 of the documentation is for the Talos version being developed. For the latest stable version of Talos, see the latest version.

HostnameConfig

HostnameConfig is a config document to configure the hostname: either a static hostname or an automatically generated hostname.
apiVersion: v1alpha1
kind: HostnameConfig
hostname: worker-33 # A static hostname to set for the machine.
apiVersion: v1alpha1
kind: HostnameConfig
auto: stable # A method to automatically generate a hostname for the machine.

# # A static hostname to set for the machine.
# hostname: controlplane1
# hostname: controlplane1.example.org
FieldTypeDescriptionValue(s)
autoAutoHostnameKindA method to automatically generate a hostname for the machine.

There are two methods available:
- stable - generates a stable hostname based on machine identity
- off - disables automatic hostname generation, Talos will wait for an external source to provide a hostname (DHCP, cloud-init, etc).

Automatic hostnames have the lowest priority over any other hostname sources: DHCP, cloud-init, etc.
Conflicts with hostname field.
stable
off
hostnamestringA static hostname to set for the machine.

This hostname has the highest priority over any other hostname sources: DHCP, cloud-init, etc.
Conflicts with auto field.
Show example(s)
hostname: controlplane1
hostname: controlplane1.example.org
Last modified September 9, 2025: feat: implement HostConfig multi-doc (a2122ee5c)