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 a package management tool. The lists of
repositories are defined in /etc/apt/sources.list
and the .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
.
/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 repository from Proxmox to get Proxmox Backup updates.
During the Proxmox Backup beta phase, only one repository (pbstest) will be available. Once released, an 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 verification key 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 access this repository by adding the following line to
/etc/apt/sources.list
:
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 allow you to partition the local disk(s), apply basic system configurations (e.g. timezone, language, network), and install 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.
Caution
Installing Proxmox Backup on top of an existing Debian installation looks easy, but it assumes that the base system and local storage have 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