Installation

Proxmox Backup is split into a server and client part. The server part can either be installed with a graphical installer or on top of Debian from the provided package repository.

Debian Package Repositories

All Debian based systems use APT as package management tool. The list of repositories is defined in /etc/apt/sources.list and .list files found in the /etc/apt/sources.d/ directory. Updates can be installed directly with the apt command line tool, or via the GUI.

APT sources.list files list one package repository per line, with the most preferred source listed first. Empty lines are ignored and a # character anywhere on a line marks the remainder of that line as a comment. The information available from the configured sources is acquired by apt update.

File: /etc/apt/sources.list
deb http://ftp.debian.org/debian buster main contrib
deb http://ftp.debian.org/debian buster-updates main contrib

# security updates
deb http://security.debian.org/debian-security buster/updates main contrib

In addition, you need a package repositories from Proxmox to get the backup server updates.

During the Proxmox Backup beta phase only one repository (pbstest) will be available. Once released, a Enterprise repository for production use and a no-subscription repository will be provided.

SecureApt

The Release files in the repositories are signed with GnuPG. APT is using these signatures to verify that all packages are from a trusted source.

If you install Proxmox Backup Server from an official ISO image, the key for verification is already installed.

If you install Proxmox Backup Server on top of Debian, download and install the key with the following commands:

# wget http://download.proxmox.com/debian/proxmox-ve-release-6.x.gpg -O /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg

Verify the SHA512 checksum afterwards with:

# sha512sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg

The output should be:

acca6f416917e8e11490a08a1e2842d500b3a5d9f322c6319db0927b2901c3eae23cfb5cd5df6facf2b57399d3cfa52ad7769ebdd75d9b204549ca147da52626 /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg

and the md5sum:

# md5sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg

Here, the output should be:

f3f6c5a3a67baf38ad178e5ff1ee270c /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg

Proxmox Backup Beta Repository

During the public beta, there is a repository called pbstest. This one contains the latest packages and is heavily used by developers to test new features.

You can configure this using /etc/apt/sources.list by adding the following line:

sources.list entry for pbstest
deb http://download.proxmox.com/debian/pbs buster pbstest

If you installed Proxmox Backup Server from the official beta ISO you should have this repository already configured in /etc/apt/sources.list.d/pbstest-beta.list

Server installation

The backup server stores the actual backed up data and provides a web based GUI for various management tasks such as disk management.

Note

You always need a backup server. It is not possible to use Proxmox Backup without the server part.

The disk image (ISO file) provided by Proxmox includes a complete Debian system (“buster” for version 1.x) as well as all necessary packages for the Proxmox Backup server.

The installer will guide you through the setup process and allows you to partition the local disk(s), apply basic system configurations (e.g. timezone, language, network), and installs all required packages. The provided ISO will get you started in just a few minutes, and is the recommended method for new and existing users.

Alternatively, Proxmox Backup server can be installed on top of an existing Debian system.

Install Proxmox Backup with the Installer

Download the ISO from https://www.proxmox.com/downloads. It includes the following:

  • The Proxmox Backup server installer, which partitions the local disk(s) with ext4, ext3, xfs or ZFS, and installs the operating system.
  • Complete operating system (Debian Linux, 64-bit)
  • Our Linux kernel with ZFS support.
  • Complete tool-set to administer backups and all necessary resources
  • Web based GUI management interface

Note

During the installation process, the complete server is used by default and all existing data is removed.

Install Proxmox Backup server on Debian

Proxmox ships as a set of Debian packages which can be installed on top of a standard Debian installation. After configuring the Debian Package Repositories, you need to run:

# apt-get update
# apt-get install proxmox-backup-server

The commands above keep the current (Debian) kernel and install a minimal set of required packages.

If you want to install the same set of packages as the installer does, please use the following:

# apt-get update
# apt-get install proxmox-backup

This will install all required packages, the Proxmox kernel with ZFS support, and a set of common and useful packages.

Installing Proxmox Backup on top of an existing Debian installation looks easy, but it presumes that the base system and local storage has been set up correctly.

In general this is not trivial, especially when LVM or ZFS is used.

The network configuration is completely up to you as well.

Note

You can access the webinterface of the Proxmox Backup Server with
your web browser, using HTTPS on port 8007. For example at

https://<ip-or-dns-name>:8007

Install Proxmox Backup server on Proxmox VE

After configuring the Debian Package Repositories, you need to run:

# apt-get update
# apt-get install proxmox-backup-server

Caution

Installing the backup server directly on the hypervisor is not recommended. It is safer to use a separate physical server to store backups. Should the hypervisor server fail, you can still access the backups.

Note

You can access the webinterface of the Proxmox Backup Server with
your web browser, using HTTPS on port 8007. For example at

https://<ip-or-dns-name>:8007

Client installation

Install Proxmox Backup client on Debian

Proxmox ships as a set of Debian packages to be installed on top of a standard Debian installation. After configuring the Debian Package Repositories, you need to run:

# apt-get update
# apt-get install proxmox-backup-client

Installing from source

Todo

Add section “Installing from source”

Installing statically linked binary

Todo

Add section “Installing statically linked binary”