Skip to main content

Setup a new PBS client

Proxmox Backup Client on Raspberry Pi (ARM64) — Community Setup Guide

This guide installs proxmox-backup-client on a Raspberry Pi (ARM64) and schedules backups to your existing PBS server (no PBS web UI on the Pi).

Tip: Try to keep the client major version close to your PBS major version. Proxmox tests compatibility across current major versions, but “two or more releases apart” is best-effort.


1) Requirements

  • Raspberry Pi running 64-bit OS (aarch64)

  • Network access to your PBS server (default port 8007)

  • A PBS user + API token (recommended)

Check ARM64:


uname -m
# should be: aarch64

2) Install the client (community ARM64 packages)

We’ll use the community ARM64 build repo wofferl/proxmox-backup-arm64 to download prebuilt .deb packages.

A) Download packages


sudo apt update
sudo apt install -y git ca-certificates curl

cd /tmp
git clone https://github.com/wofferl/proxmox-backup-arm64.git
cd proxmox-backup-arm64

# Choose branch (common pattern):
# - Debian 12 / Bookworm:   git checkout stable-3
# - Debian 13 / Trixie:     stay on main
#
# Pick a VERSION tag from the repo releases page.
# Example (as seen in your packages folder):
VERSION="4.1.1-1"

./build.sh download=$VERSION

B) Install ONLY the client packages


cd /tmp/proxmox-backup-arm64/packages

# minimal client install
sudo apt install -y ./proxmox-mini-journalreader_*_arm64.deb ./proxmox-backup-client_*_arm64.deb

# optional: restore tool
sudo apt install -y ./proxmox-backup-file-restore_*_arm64.deb

proxmox-backup-client version

Don’t install proxmox-backup-server_*.deb on the Pi if you only need a client.