dockur / proxmox

What is proxmox?

This project packages Proxmox VE, a full datacenter manager for running virtual machines and isolated LXC containers, into a Docker container. It gives you the entire Proxmox web interface on port 8006 with the ability to spin up VMs and containers without dedicated hardware. Built with a Dockerfile and bash entrypoint, it handles nested virtualization by requiring KVM support and privileged mode. You pass in a root password via environment variable and bind mount two volumes for storage and configuration persistence.

Why is it gaining traction?

The hook is simple: you get a complete Proxmox installation with one docker run command. For developers who want to test Proxmox helper scripts, evaluate it for a homelab, or prototype infrastructure before committing to a bare-metal install, this removes the friction of a full proxmox download and installation. The project includes GitHub Actions for automated builds, making it easy to track the latest version. The web UI handles networking configuration through the Docker bridge, and the FAQ covers the KVM requirements clearly for users running inside other hypervisors like ESXi or VirtualBox.

Who should use this?

Homelab enthusiasts who want to experiment with Proxmox without reinstalling their server. DevOps engineers prototyping backup server workflows or testing proxmox github actions runner integrations. Developers evaluating Proxmox as a datacenter manager for small projects. Not recommended for production workloads yet given the maturity level.

Verdict

An clever workaround for running Proxmox inside Docker, but with only 14 stars and a credibility score of 0.8%, this is experimental software. The documentation is solid and the concept works, but you should not rely on this for anything mission-critical until it gains more community traction and production battle-testing.