Proxmox-GitOps
Self-hosted GitOps IaC Container Automation on Proxmox VE.
4 followers
Self-hosted GitOps IaC Container Automation on Proxmox VE.
4 followers
Proxmox-GitOps implements a self-contained GitOps environment for provisioning and orchestrating Linux Containers (LXC) on Proxmox VE. It provides a comprehensive Infrastructure-as-Code (IaC) abstraction for an entire, automated container-based infrastructure.
I‘d like to share my hobby and passion project Proxmox-GitOps (Open Source, MIT), which could be interesting for you if you are looking for a comprehensive Infrastructure-as-Code (IaC) abstraction to automate an entire infrastructure stack on Proxmox VE.
https://github.com/stevius10/Proxmox-GitOps
Demo (~1min): https://youtu.be/2oXDgbvFCWY
Proxmox-GitOps implements a self-contained GitOps environment for provisioning and orchestrating Linux Containers (LXC) on Proxmox VE.
Encapsulating infrastructure within an extensible monorepository — recursively resolved from Git submodules at runtime — it provides a comprehensive Infrastructure-as-Code (IaC) abstraction for an entire, automated container-based infrastructure.
Core Concepts
* Recursive Self-Management: The control plane executes from within the managed containers to maximize reproducibility and minimize configuration drift.
* Git as Current Desired State: All operations map to standard Git workflows (commit, merge, rollback) in a completely stateless management model.
* Convention-Based Extensibility: Add a new service by copying a container definition from the `libs` directory, adding a minimal cookbook and a `config.env` file. The pipeline automatically handles provisioning, configuration, and validation.
* Loose Coupling: Containers remain independently replaceable and continue to function without requiring manual follow-up actions after changes.
Environment
* Proxmox VE: 8.4–9.0
* Container: Debian 13 LXC (default)
* Local bootstrap via Docker
I‘d love to hear your thoughts 🙂
I am excited to introduce my project Proxmox-GitOps, which was born from the idea to bring industry and enterprise automation standards to PVE.
What am I looking for?
Honestly, this my great passion: I am not looking for anything but other passionated engineers to build up a generic IaC Infrastructure abstraction targeting an entire automation following best practices.
If it sounds interesting for you I would appreciate a lot if you‘d have a look at it 🙂