Installation

Install Cloud-PBS TUI and its dependencies with the install script or manually.

Last updated: May 26, 2026

Cloud-PBS TUI is available for Linux amd64 (x86-64), the only architecture for which Proxmox ships proxmox-backup-client. On any other architecture the backup client does not exist and the tool cannot do anything.

The install script sets up Cloud-PBS TUI and its dependencies (proxmox-backup-client, FUSE):

curl -fsSL https://cloud-pbs.com/downloads/cloudpbs-tui/install.sh | sudo bash

The script:

  • checks the architecture and stops if it is not amd64;
  • on Debian and Ubuntu, adds Proxmox’s official pbs-client repository and installs proxmox-backup-client and fuse3 through apt;
  • on other distributions, installs the static proxmox-backup-client-static binary published by Proxmox, then FUSE through the detected package manager;
  • installs cloudpbs-tui into /usr/local/bin.

Choosing the Proxmox repository suite

The script auto-detects the target machine’s Debian release from /etc/os-release and pulls proxmox-backup-client from the matching Proxmox pbs-client suite (bookworm for Debian 12, trixie for Debian 13, bullseye for Debian 11). On Ubuntu or an unrecognised distribution, it falls back to bookworm with a warning.

If the auto-detection misbehaves on your environment, force a specific suite with the PROXMOX_SUITE variable:

curl -fsSL https://cloud-pbs.com/downloads/cloudpbs-tui/install.sh | sudo PROXMOX_SUITE=trixie bash

Manual installation

You can also install the binary on its own. Download the archive and its checksum:

  • https://cloud-pbs.com/downloads/cloudpbs-tui/cloudpbs-tui-linux-amd64.tar.gz
  • https://cloud-pbs.com/downloads/cloudpbs-tui/SHA256SUMS

Verify the archive, then extract it:

sha256sum -c SHA256SUMS
tar xzf cloudpbs-tui-linux-amd64.tar.gz
sudo install cloudpbs-tui /usr/local/bin/

In this case, proxmox-backup-client and fuse3 still have to be installed separately:

  • Debian / Ubuntu: add Proxmox’s pbs-client repository, then apt install proxmox-backup-client fuse3.
  • Other distributions: install the static proxmox-backup-client-static binary from download.proxmox.com, and fuse3 through your package manager.

Verify the installation

Launch the tool:

cloudpbs-tui

The Home screen appears. If proxmox-backup-client is missing, a banner says so at the top of the interface: real backups will only be possible once the client is installed.

Updating

Cloud-PBS TUI ships a built-in update manager. Open the Home screen (key 1) and press u: the tool queries the latest version published on cloud-pbs.com, shows the running version next to it and, if a newer release is available, downloads the binary, verifies its SHA-256 against SHA256SUMS and atomically replaces itself in place. Quit and relaunch the tool to run the new version.

The replacement is safe even while the binary is running: Linux keeps the inode alive until the process exits.

Alternative methods, useful for unattended hosts or when the TUI cannot be opened:

  • Re-run the install script to fetch the latest binary and its dependencies in one go: 
    curl -fsSL https://cloud-pbs.com/downloads/cloudpbs-tui/install.sh | sudo bash
  • Manual update: download the archive and checksum from https://cloud-pbs.com/downloads/cloudpbs-tui/, verify with sha256sum -c SHA256SUMS, extract and install over the existing binary.

On Debian and Ubuntu, proxmox-backup-client is updated along with the rest of the system by apt and does not need a Cloud-PBS TUI update to pick up changes.