> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siderolabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

> HostnameConfig is a config document to configure the hostname: either a static hostname or an automatically generated hostname.

# HostnameConfig

```yaml theme={null}
apiVersion: v1alpha1
kind: HostnameConfig
hostname: worker-33 # A static hostname to set for the machine.
```

```yaml theme={null}
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
```

<table>
  <thead>
    <tr>
      <th>Field</th>
      <th>Type</th>
      <th>Description</th>
      <th>Value(s)</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>`auto`</td>
      <td>AutoHostnameKind</td>
      <td>A method to automatically generate a hostname for the machine.<br /><br />There are two methods available:<br /> - `stable` - generates a stable hostname based on machine identity<br /> - `off` - disables automatic hostname generation, Talos will wait for an external source to provide a hostname (DHCP, cloud-init, etc).<br /><br />Automatic hostnames have the lowest priority over any other hostname sources: DHCP, cloud-init, etc.<br />Conflicts with `hostname` field.</td>
      <td>`stable`<br />`off`<br /></td>
    </tr>

    <tr>
      <td>`hostname`</td>
      <td>string</td>
      <td>A static hostname to set for the machine.<br /><br />This hostname has the highest priority over any other hostname sources: DHCP, cloud-init, etc.<br />Conflicts with `auto` field.</td>

      <td />
    </tr>
  </tbody>
</table>