dockurr/proxmox-backup repository overview

⁠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 root and the password you specified in the PASSWORD environment 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:

1. Edit /boot/firmware/config.txt on the host system.
2. Add the following line at the end:

   kernel=kernel8.img
   

   Copy
3. 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.