Bos55/nix-config
2
Fork 1
Code Issues 2 Pull requests Projects Releases Packages Wiki Activity

docs: clarify proxmox fresh install state and potential breaking changes

Browse source
This commit is contained in:
Tibo De Peuter 2026-07-22 20:52:28 +02:00
parent 95e67dd151
commit 501cda6402
Signed by: tdpeuter
SSH key fingerprint: SHA256:u/h/LVoqKF1Iz02uOyxe6hcjmoZASCGV2HM0TG9ZMoU
1 changed files with 11 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

13
BOOTSTRAP.md
View file

@ -23,9 +23,18 @@ We use `sops-nix` to manage secrets, adhering to a strict separation between Pro
3. **Update Configuration:**
Open both `.txt` files and copy their **Public Keys** (the strings starting with `age1...`). Open `.sops.yaml` in the root of this repository and replace the `# TODO` placeholders with your newly generated public keys. Commit and push this change.
## 2. Proxmox Hypervisor Authentication
## 2. Proxmox Hypervisor Authentication & State
The CI/CD pipeline needs restricted API access to Proxmox to provision Virtual Machines.
The CI/CD pipeline needs restricted API access to Proxmox to provision Virtual Machines.
### Fresh Install vs. Existing Install
> [!WARNING]
> This repository assumes a standard, fresh installation of Proxmox VE.
>
> **If you are NOT starting from a fresh install, be aware of these potential breaking changes:**
> * **VM ID Conflicts:** Terraform automatically assigns VM IDs. If you have existing VMs, Terraform might fail to provision or (if misconfigured) attempt to overwrite them. Check your Terraform variables to ensure the ID range (e.g., 8000+) does not conflict.
> * **Storage Pools:** The automation assumes the default Proxmox storage pools (`local` for snippets/ISOs, and `local-lvm` or `local-zfs` for VM disks). If you renamed your pools, you must update the Terraform configuration.
> * **Network Bridges:** It assumes `vmbr0` is available for VM networking.
**Prerequisites:** Install `terraform` ([Terraform installation](https://developer.hashicorp.com/terraform/downloads)).