Proxmox First Boot Runbook

When To Use

Use this runbook immediately after installing or reinstalling the Proxmox host.

[!CAUTION] This runbook documents current-state Proxmox work. ADR-0013 decides whether the homelab substrate remains Proxmox or moves to NixOS plus Incus. Do not use this page as proof that Proxmox is the final platform substrate.

Procedure

Confirm host identity and network.
Terminal window
```
hostnamectl
ip address
ip route
```
Expected result: hostname and management network match the installation answer file.
Run Ansible in check mode before mutation.
Terminal window
```
ansible-playbook homelab-platform/ansible/playbooks/proxmox-host.yml --check --diff
```
Expected result: proposed changes are understandable and limited to host hardening.
Apply only after reviewing the diff.
Terminal window
```
ansible-playbook homelab-platform/ansible/playbooks/proxmox-host.yml --diff
```
Expected result: SSH hardening, fail2ban and update policy converge.

Validation

Confirm SSH key login still works before closing the current session.

If This Does Not Work

Use local console access. Do not reboot repeatedly until network and SSH configuration are understood.