dockur/proxmox

This project packages Proxmox VE, a platform used to run and manage virtual machines, so that it runs inside a Docker container. Proxmox is normally installed directly onto a physical server, but this project lets you spin it up and tear it down quickly as a container instead, which is handy for testing, home labs, or temporary setups. The container uses KVM acceleration so virtual machines inside it perform close to how they would running directly on bare metal. It comes with a preconfigured network bridge that hands out addresses automatically, and it supports LXC containers out of the box. There is also support for ARM64 processors through a related project called PXVIRT, alongside the usual x86 support. To use it, you run the container with Docker Compose or the Docker command line, setting a root password through an environment variable and mapping port 8006 for the web interface. Two folders get mounted as volumes, one for the storage pool where disk images and ISO files live, and one for Proxmox's own configuration data, so your setup survives container restarts. Once running, you open port 8006 in a browser and log in with the username root and the password you chose. Because it relies on hardware virtualization, the host machine needs Intel VT-x or AMD-V support enabled, a reasonably recent Linux kernel, and a modern version of Docker. Running it inside Windows works too, through Docker Desktop and WSL2, as long as nested virtualization is turned on. The README includes a troubleshooting section for checking whether your system actually supports the needed virtualization features, and notes that most cloud VPS providers block nested virtualization, so this generally will not work on typical rented cloud servers. The README credits two other contributors for work the project depends on and does not state a license.