Installer Proxmox Backup Client sur Rocky, Alma, Fedora, Alpine, ARM et autres Linux non-Debian

Si vous êtes sur Debian ou Ubuntu, la procédure officielle est courte et vit dans notre documentation : voir Installation du Proxmox Backup Client. Ce guide couvre tout le reste : Rocky Linux, AlmaLinux, RHEL, Fedora, Alpine, Arch, openSUSE, hôtes ARM (Raspberry Pi et similaires) et exécution du client dans un conteneur.

La bonne nouvelle : le client est désormais distribué sous forme de binaire compilé statiquement, ce qui le rend utilisable sur presque n’importe quelle distribution Linux sans rien recompiler.

Pourquoi pas de paquet officiel pour votre distribution ?

L’équipe Proxmox publie officiellement des dépôts APT uniquement pour Debian (et ses dérivés comme Ubuntu). Il n’y a pas de paquet RPM natif, ni d’APK Alpine, ni de PKG Arch. Cela ne veut pas dire qu’on ne peut pas faire tourner le client ailleurs : il faut juste passer par l’une des méthodes ci-dessous.

Méthode 1 : télécharger le .deb statique depuis le miroir Proxmox et en extraire le binaire (recommandée)

Depuis juin 2025, Proxmox publie un paquet proxmox-backup-client-static. Le binaire qu’il contient a toutes ses dépendances liées en statique, donc il tourne sur n’importe quel Linux glibc x86_64. À noter : proxmox-backup-client-static n’est pas dans les dépôts Debian/Ubuntu standards, il vit dans le dépôt Proxmox pbs-client à http://download.proxmox.com/debian/pbs-client/.

La bonne nouvelle, c’est que le .deb est hébergé directement sur le miroir Proxmox : pas besoin d’ajouter le dépôt APT ni même d’avoir apt sur votre machine. Téléchargez le paquet et extrayez le binaire :

# 1. Telecharger le .deb statique le plus recent depuis le miroir Proxmox.
#    Version actuelle au moment de la redaction : 3.4.6-1.
wget http://download.proxmox.com/debian/pbs-client/dists/bookworm/main/binary-amd64/proxmox-backup-client-static_3.4.6-1_amd64.deb

# 2a. Avec dpkg disponible (Debian, Ubuntu) :
dpkg-deb -x proxmox-backup-client-static_*_amd64.deb extracted/

# 2b. Sans dpkg (Rocky, Alma, RHEL, Fedora, Alpine, ...) :
ar x proxmox-backup-client-static_*_amd64.deb
mkdir -p extracted && tar -xf data.tar.* -C extracted/

# 3. Installer le binaire dans le PATH.
install -m 0755 extracted/usr/bin/proxmox-backup-client /usr/local/bin/
proxmox-backup-client version

Pour choisir une autre version, consultez l’index des paquets à http://download.proxmox.com/debian/pbs-client/dists/bookworm/main/binary-amd64/Packages (utilisez bullseye ou buster pour une toolchain plus ancienne).

Certaines images Alpine n’embarquent pas zstd par défaut. Si tar -xf data.tar.zst échoue, installez-le : apk add zstd.

Méthode 2 : copier depuis un hôte Debian où le dépôt Proxmox est configuré (raccourci)

Si vous avez déjà une machine Debian ou Ubuntu avec le dépôt Proxmox pbs-client configuré (un hôte Proxmox VE, un serveur PBS, ou n’importe quel Debian où vous avez suivi notre procédure d’installation pour ajouter le dépôt), vous pouvez installer le paquet via APT puis copier le binaire :

# Sur l'hote Debian avec le depot Proxmox configure
apt update
apt install proxmox-backup-client-static

# Copier le binaire vers la machine cible (Rocky, Fedora, etc.)
scp /usr/bin/proxmox-backup-client root@cible:/usr/local/bin/

Puis sur la machine cible :

chmod +x /usr/local/bin/proxmox-backup-client
proxmox-backup-client version

Notes par distribution

Rocky Linux 9 / AlmaLinux 9 / RHEL 9

Testé et fonctionnel avec le binaire statique ci-dessus. Aucune dépendance supplémentaire requise.

[root@rocky9 ~]# /usr/local/bin/proxmox-backup-client version
client version: 3.4.1

Fedora 41 et versions ultérieures

Testé également. Le binaire statique tourne sans paquet supplémentaire.

[root@fedora41 ~]# /usr/local/bin/proxmox-backup-client version
client version: 3.4.1

Alpine Linux

Alpine utilise musl libc, pas glibc, donc le binaire statique standard ne tourne pas tel quel. Deux options :

• Exécuter le client dans un conteneur Debian sur Alpine (voir Méthode 3 ci-dessous). Le plus simple.
• Installer gcompat (apk add gcompat), la couche de compatibilité glibc pour Alpine. Cela fonctionne pour beaucoup de binaires glibc mais n’est pas officiellement supporté pour le client PBS. À tester avant de s’y fier.

Arch Linux et openSUSE

Les deux embarquent glibc. Le binaire statique fonctionne en principe immédiatement, comme sur Rocky/Fedora. Il existe également un paquet AUR communautaire sur Arch (proxmox-backup-client), maintenu en dehors de l’équipe Proxmox : pratique mais non officiel.

Hôtes ARM (Raspberry Pi, serveurs ARM)

Contrainte importante : le dépôt APT Proxmox pbs-client ne publie officiellement que des paquets amd64. Le fichier Release à download.proxmox.com/debian/pbs-client/dists/bookworm/Release déclare Architectures: amd64, et le binaire proxmox-backup-client-static est lui aussi x86_64. Il n’existe pas de build arm64 officiel aujourd’hui, ni sur Debian ni ailleurs.

Cela vaut quelle que soit votre distribution : Raspberry Pi OS 64-bit, Ubuntu Server ARM, Debian sur ARM, Alpine sur ARM. Aucun ne peut faire apt install proxmox-backup-client depuis le dépôt Proxmox.

Deux options réalistes :

• Compiler depuis les sources (Méthode 4 ci-dessous) : le client est écrit en Rust et compile proprement sur ARM. Prévoyez d’installer une toolchain Rust et quelques paquets -dev, puis 20 à 30 minutes sur le premier build.
• Exécuter un conteneur Debian amd64 sous émulation (Docker Buildx + QEMU, --platform=linux/amd64) : fonctionne sur tout hôte ARM, mais avec une pénalité CPU importante. Acceptable pour de petites sauvegardes, douloureux pour plusieurs téraoctets.

Si vous êtes sur Debian/ARM et que vous tenez à passer par APT, surveillez le bug tracker Proxmox : l’ajout de arm64 au dépôt pbs-client a été demandé mais n’est pas encore livré.

Méthode 3 : exécuter le client dans un conteneur Debian

Si votre distribution est Alpine, si vous ne voulez pas installer de couche de compatibilité glibc, ou si vous voulez simplement garder votre hôte propre, exécutez le client dans un conteneur Debian. Cela fonctionne sur tout hôte disposant de Docker, Podman ou LXC.

Un Dockerfile minimal :

FROM debian:bookworm-slim

RUN apt-get update \
 && apt-get install -y --no-install-recommends ca-certificates wget gnupg \
 && wget -q https://enterprise.proxmox.com/debian/proxmox-release-bookworm.gpg \
        -O /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg \
 && echo "deb http://download.proxmox.com/debian/pbs-client bookworm main" \
        > /etc/apt/sources.list.d/pbs-client.list \
 && apt-get update \
 && apt-get install -y --no-install-recommends proxmox-backup-client \
 && apt-get clean && rm -rf /var/lib/apt/lists/*

ENTRYPOINT ["proxmox-backup-client"]

Construire et l’utiliser :

docker build -t pbs-client .

# Sauvegarder /data depuis l'hôte
docker run --rm \
  -v /data:/data:ro \
  pbs-client backup root.pxar:/data \
  --repository user@pbs!token@votre-instance-cloud-pbs:store

Pour une sauvegarde système, montez en lecture seule les répertoires nécessaires et exécutez le client en root à l’intérieur du conteneur. Pour Podman, remplacez docker par podman : la syntaxe est identique.

Méthode 4 : compiler depuis les sources

Pour ARM sur non-Debian, ou si vous voulez un build audité, les sources du client sont publiques. Clonez le dépôt Git Proxmox et suivez son README :

git clone git://git.proxmox.com/git/proxmox-backup.git
cd proxmox-backup
# Suivre les instructions de build dans README.md (toolchain Rust requise)

Cette voie s’adresse aux utilisateurs avancés. Prévoyez d’installer une toolchain Rust récente, plusieurs paquets système -dev, et de passer 20 à 30 minutes sur le premier build.

Choisir sa méthode

Méthode	Distributions couvertes	Effort	Quand la choisir
1. Téléchargement du .deb depuis le miroir Proxmox + extraction	Rocky, Alma, RHEL, Fedora, Arch, openSUSE (x86_64 uniquement)	Faible	Choix par défaut pour glibc x86_64, sans hôte Debian requis
2. Copie depuis un hôte Debian avec le dépôt Proxmox configuré	Mêmes que ci-dessus (x86_64 uniquement)	Faible	Raccourci quand on gère déjà un PVE/PBS ou un hôte Debian
3. Conteneur Debian	Tout hôte avec Docker/Podman/LXC (x86_64 natif, ARM via émulation amd64)	Faible	Alpine, hôte à garder propre, ARM en repli
4. Compilation depuis les sources	Tout hôte avec une toolchain Rust	Élevé	ARM (toute distribution), builds audités, fonctionnalités personnalisées

Après l’installation : test rapide

Quelle que soit la méthode, validez l’installation :

proxmox-backup-client version
proxmox-backup-client list \
  --repository user@pbs!token@votre-instance-cloud-pbs:store

Si list retourne vos snapshots (ou une liste vide sans erreur), l’authentification et le réseau sont bons.

Pour les commandes de sauvegarde proprement dites et la mise en place du timer systemd, la procédure est identique à Debian : consultez la documentation Installation du Proxmox Backup Client pour la référence complète.

Utiliser avec Cloud-PBS

Le même client se connecte à n’importe quel Proxmox Backup Server, Cloud-PBS inclus. Récupérez l’URL du dépôt et le token API depuis votre tableau de bord Cloud-PBS, puis branchez-les sur l’option --repository de n’importe quelle commande proxmox-backup-client. Aucune configuration supplémentaire.

Dépannage

Si quelque chose ne fonctionne pas, les problèmes les plus fréquents ont leur propre guide :

• Backup owner check failed
• PBS Client error: missing key

Si le binaire refuse de tourner sur votre distribution, vérifiez que vous avez bien glibc (ldd --version). Les systèmes musl (Alpine, certaines distros embarquées) doivent passer par la Méthode 2.