# 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)