From 501cda640262e08757a89e646c0fb6da90e86ca6 Mon Sep 17 00:00:00 2001 From: Tibo De Peuter Date: Wed, 22 Jul 2026 20:52:28 +0200 Subject: [PATCH] docs: clarify proxmox fresh install state and potential breaking changes --- BOOTSTRAP.md | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/BOOTSTRAP.md b/BOOTSTRAP.md index e9df6c2..0db25b7 100644 --- a/BOOTSTRAP.md +++ b/BOOTSTRAP.md @@ -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)).