Hostname Naming Convention¶

The following defines my naming convention for the hostname structure used across all infrastructure. This includes homelab, cloud providers, virtual machines, and containers.

Design Principles¶

• Consistent structure across homelab and cloud.
• Hybrid friendly.
• Migration safe for virtual machines.
• Predictable for automation and scripting.
• Simple enough to maintain long term.

Hostname Format¶

All systems follow this format:

<Provider>-<Site>-<Environment>-<Type>-<Role><Number>

Example:

hml-home-prd-phy-nas01

Try to have every hostname contain all five fields for consistency.

Fields¶

Provider¶

Identifies who owns or operates the infrastructure.

Common values:

- hml   Personal homelab
- aws   Amazon Web Services
- htz   Hetzner
- ocl   Oracle Cloud
- cdf   Cloudflare

Keep provider codes short and stable.

Site¶

Identifies the physical or regional location.

Homelab examples:

- home
- parents

Cloud examples:

- use1   AWS us-east-1
- usw2   AWS us-west-2
- hel1   Hetzner Helsinki
- fsn1   Hetzner Falkenstein

Try to include site value for all systems, even if there is only one location.

Environment¶

Identifies lifecycle or purpose.

Common values:

- prd   Production
- lab   Experimental
- dev   Development
- stg   Staging

Type¶

Identifies how the system runs.

Common values:

- phy   Physical machine
- vm    Virtual machine
- lxc   Proxmox container

Type describes platform, not function.

Role¶

Describes what the system does.

Examples:

- hv     Proxmox hypervisor
- nas    Storage server
- web    Web server
- db     Database server
- int    Internal services
- dns    DNS server
- vpn    VPN server
- mon    Monitoring
- proxy  Reverse proxy
- backup Backup server

Role names should be short and consistent.

Number¶

Two digit identifier per role within the same provider, site, and environment.

Examples:

- hv01
- web01
- web02
- db01

Numbering starts at 01 and increments as needed.

Examples¶

Homelab at primary home¶

hml-home-prd-phy-hv01
hml-home-prd-phy-hv02
hml-home-prd-phy-nas01

hml-home-prd-vm-web01
hml-home-prd-vm-db01
hml-home-prd-vm-int01

hml-home-prd-lxc-dns01
hml-home-prd-lxc-vpn01

Homelab at secondary location¶

hml-parents-prd-phy-hv01
hml-parents-prd-vm-backup01

AWS¶

aws-use1-prd-vm-web01
aws-use1-prd-vm-api01

Hetzner¶

htz-hel1-prd-vm-edge01

Rules¶

1. All hostnames are lowercase.
2. Use hyphens between fields.
3. Always include all five fields.
4. Do not encode hardware model, storage, or cluster node.
5. Do not encode the Proxmox host into VM or container names.
6. Keep role names short and consistent.
7. Only increment numbers within the same provider, site, environment, and role.