ramonvanraaij/proxmox-backup-server repository overview

⁠🛡️ Proxmox Backup Server (PBS)

This image provides a high-performance, containerized build of Proxmox Backup Server (PBS).

Built using official Proxmox repositories, this container is designed to be lightweight and fast. While it is heavily optimized for deployment on OpenSUSE MicroOS using Podman Quadlets, it is fully compatible with standard Docker and Docker Compose environments.

⁠🚀 Quick Start (Docker)

To quickly spin up the server using standard Docker, run the following command. Make sure to map the necessary volumes for persistence:

docker run -d \
    --name proxmox-backup-server \
    -p 8007:8007 \
    --tmpfs /run \
    -v $(pwd)/data/config:/etc/proxmox-backup \
    -v $(pwd)/data/datastores:/var/lib/proxmox-backup \
    -v $(pwd)/data/logs:/var/log/proxmox-backup \
    ramonvanraaij/proxmox-backup-server:latest

(Note: If pulling directly from the GitHub Container Registry, use ghcr.io/ramonvanraaij/proxmox-backup-server:latest)

⁠⚙️ Access & Default Credentials

Once the container is running, you can access the Proxmox Backup Server web interface via your web browser.

• 🖥️ Web UI: https://<your-host-ip>:8007
• 🔑 Default Username: admin@pbs
• 🔑 Default Password: pbspbs

⁠📂 Storage Paths & Volumes

To ensure your backups, logs, and server configurations persist across container restarts and updates, you must mount the following directories:

⁠🏗️ OpenSUSE MicroOS & Podman Support

If you are running OpenSUSE MicroOS, this project features a specialized build system and deployment configuration utilizing native systemd integration via Podman Quadlets (.container units), interactive NFS setup, and more.

For the full deployment wizard, automated test suites, and MicroOS-specific setup scripts, please visit the GitHub Repository⁠.

⁠🤝 Credits & Maintenance

• Developed and maintained by Rámon van Raaij⁠.
• This project is an extensive refactor and specialization based on the original work by Kamil Trzciński.

⁠Found this helpful?

Consider supporting the project via Bunq.me⁠ or PayPal⁠.

⁠⚖️ Licensing & AGPLv3 Compliance

This container image distributes Proxmox Backup Server, open-source software licensed under the GNU Affero General Public License, version 3 or later (AGPL-3.0-or-later) by Proxmox Server Solutions GmbH. The image installs unmodified PBS packages from the official Proxmox APT repositories.

• 📖 Corresponding source (AGPL-3.0 source disclosure): the complete source code for Proxmox Backup Server is available at git.proxmox.com⁠ (proxmox-backup repository⁠). Version-specific upstream changelogs are linked from every GitHub Release⁠.
• 🧰 Build system & deployment scripts: licensed under the Apache License 2.0. Source code, full licensing details, and upstream attribution: github.com/ramonvanraaij/MicroOS-PBS⁠ - see LICENSE.md⁠.
• Users and redistributors of this image are responsible for their own AGPL-3.0 compliance when conveying it further.