CEDILLE/opnsense-cloudinit
11
0
Fork 0
Code Issues Pull requests Projects Releases 1 Packages Wiki Activity Actions
Page: Home
Pages
Architecture Development Extension Reference Home Testing New Releases Usage
1 Home
Louis Raymond edited this page 2026-08-19 13:48:46 -04:00
Table of Contents

opnsense-cloudinit

Unattended OPNsense provisioning for Proxmox VE via standard NoCloud cloud-init. Automates OPNsense's normally-manual bring-up: install from ISO, assign LAN, and configure interfaces/addressing/VLANs/SSH — everything the setup wizard would otherwise ask for by hand — by parsing a standard Proxmox NoCloud seed and rendering it directly into /conf/config.xml. No cloud-init package ever runs inside the guest.

Code: git.etsmtl.club/CEDILLE/opnsense-cloudinit

Pages

  • Architecture — how the pipeline fits together, and the contracts (merge-not-generate, MAC-based resolution, idempotency) that make it safe
  • Usage — deploying a VM (Proxmox GUI/qm/OpenTofu)
  • Extension-Reference — the opnsense: seed extension for VLANs, role overrides, and API keys
  • Development — building the base image, running tests, repo layout, the installer automation walkthrough, known gotchas
  • Testing-New-Releases — procedure for validating against a new (or different) OPNsense release

Home