readme.md
August 9, 2026 · View on GitHub
Proxmox Backup Server
Proxmox Backup Server inside a Docker container.
Features ✨
- Runs Proxmox Backup Server inside Docker
- Provides the familiar Proxmox Backup web interface
- Stores encrypted and deduplicated backups
- Supports persistent backup datastores
- Allows backup and restore of Proxmox VE guests
- Supports scheduled backups and pruning
- Works on both AMD64 and ARM64 systems
Usage 🐳
Docker Compose:
services:
pbs:
hostname: pbs
container_name: pbs
image: dockurr/proxmox-backup
environment:
TZ: "UTC"
PASSWORD: "root"
ports:
- 8007:8007
tmpfs:
- /run
volumes:
- ./config:/etc/proxmox-backup
- ./data:/var/lib/proxmox-backup
restart: always
stop_grace_period: 2m
Docker CLI:
docker run -it --rm --name pbs --hostname pbs -e "PASSWORD=root" -e "TZ=America/New_York" -p 8007:8007 --tmpfs /run -v "${PWD:-.}/config:/etc/proxmox-backup" -v "${PWD:-.}/data:/var/lib/proxmox-backup" --stop-timeout 120 docker.io/dockurr/proxmox-backup
GitHub Codespaces:
Screenshot 📸
FAQ 💬
How do I use it?
Very simple! These are the steps:
-
Start the container and connect to port 8007 using your web browser.
-
Login using the username
rootand the password you specified in thePASSWORDenvironment variable.
Enjoy your time with your brand new Proxmox Backup Server, and don't forget to star this repo!
How do I change the location of the configuration data?
To change the location of the configuration data, include the following two bind mounts in your compose file:
volumes:
- ./config:/etc/proxmox-backup
- ./data:/var/lib/proxmox-backup
Replace the example paths ./config and ./data with the desired folders or named volumes.
Is the Raspberry Pi 5 supported?
Yes, but the Raspberry Pi 5 uses a 16k page-size kernel by default, which is incompatible with Proxmox Backup Server and can result in a 400 Bad Request: EINVAL: Invalid argument error when creating backups.
To fix this:
- Edit
/boot/firmware/config.txton the host system. - Add the following line at the end:
kernel=kernel8.img - Reboot the Raspberry Pi.
This switches the system to the 4k page-size kernel, which is compatible with Proxmox Backup Server.
Are there containers available for other Proxmox products?
Yes, see our Proxmox VE, Proxmox Datacenter Manager and Proxmox Mail Gateway containers.
Acknowledgements 🙏
Special thanks to feddar and wofferl, this project would not exist without their invaluable work.
Stars 🌟
Disclaimer ⚖️
The product names, logos, brands, and other trademarks referred to within this project are the property of their respective trademark holders. This project is not affiliated, sponsored, or endorsed by Proxmox Server Solutions GmbH.

