Files
NixOS/docs/playbooks/vps-rebuild.md
Danilo Reyes dbd3af3d0f new hosts vps
2026-02-03 15:31:47 -06:00

788 B

Playbook: Rebuild VPS

  • Name: Remote rebuild of vps
  • Purpose: Apply configuration changes to the vps host from an explicitly authorized operator machine.
  • Prerequisites: Operator machine authorized; vps reachable via SSH; repo checkout.
  • Inputs: vps hostname or IP; flake path; target profile vps.
  • Steps:
    1. Ensure the operator machine is in the authorized key list for nixremote.
    2. Run the rebuild helper script with the target host details.
    3. Monitor the rebuild for completion and errors.
  • Validation:
    • vps reports the new configuration after rebuild.
    • Remote access remains available after the update.
  • Outputs: Updated vps host configuration.
  • References: docs/constitution.md (Hosts and Roles, secureHost), docs/reference/index.md (Hosts and Roles)