1 .. _sysadmin_package_repositories:
3 Debian Package Repositories
4 ---------------------------
6 All Debian based systems use APT_ as package management tool. The list of
7 repositories is defined in ``/etc/apt/sources.list`` and ``.list`` files found
8 in the ``/etc/apt/sources.d/`` directory. Updates can be installed directly
9 with the ``apt`` command line tool, or via the GUI.
11 APT_ ``sources.list`` files list one package repository per line, with the most
12 preferred source listed first. Empty lines are ignored and a ``#`` character
13 anywhere on a line marks the remainder of that line as a comment. The
14 information available from the configured sources is acquired by ``apt
17 .. code-block:: sources.list
18 :caption: File: ``/etc/apt/sources.list``
20 deb http://ftp.debian.org/debian buster main contrib
21 deb http://ftp.debian.org/debian buster-updates main contrib
24 deb http://security.debian.org/debian-security buster/updates main contrib
27 .. FIXME for 7.0: change security update suite to bullseye-security
29 In addition, you need a package repositories from Proxmox to get the backup
32 During the Proxmox Backup beta phase only one repository (pbstest) will be
33 available. Once released, a Enterprise repository for production use and a
34 no-subscription repository will be provided.
39 The `Release` files in the repositories are signed with GnuPG. APT is using
40 these signatures to verify that all packages are from a trusted source.
42 If you install Proxmox Backup Server from an official ISO image, the key for
43 verification is already installed.
45 If you install Proxmox Backup Server on top of Debian, download and install the
46 key with the following commands:
48 .. code-block:: console
50 # wget http://download.proxmox.com/debian/proxmox-ve-release-6.x.gpg -O /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
52 Verify the SHA512 checksum afterwards with:
54 .. code-block:: console
56 # sha512sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
60 .. code-block:: console
62 acca6f416917e8e11490a08a1e2842d500b3a5d9f322c6319db0927b2901c3eae23cfb5cd5df6facf2b57399d3cfa52ad7769ebdd75d9b204549ca147da52626 /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
66 .. code-block:: console
68 # md5sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
70 Here, the output should be:
72 .. code-block:: console
74 f3f6c5a3a67baf38ad178e5ff1ee270c /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
77 `Proxmox Backup`_ Enterprise Repository
78 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
80 This will be the default, stable, and recommended repository. It is available for
81 all `Proxmox Backup`_ subscription users. It contains the most stable packages,
82 and is suitable for production use. The ``pbs-enterprise`` repository is
85 .. note:: During the Proxmox Backup beta phase only one repository (pbstest)
88 .. code-block:: sources.list
89 :caption: File: ``/etc/apt/sources.list.d/pbs-enterprise.list``
91 deb https://enterprise.proxmox.com/debian/pbs buster pbs-enterprise
94 To never miss important security fixes, the superuser (``root@pam`` user) is
95 notified via email about new packages as soon as they are available. The
96 change-log and details of each package can be viewed in the GUI (if available).
98 Please note that you need a valid subscription key to access this
99 repository. More information regarding subscription levels and pricing can be
100 found at https://www.proxmox.com/en/proxmox-backup/pricing.
102 .. note:: You can disable this repository by commenting out the above
103 line using a `#` (at the start of the line). This prevents error
104 messages if you do not have a subscription key. Please configure the
105 ``pbs-no-subscription`` repository in that case.
108 `Proxmox Backup`_ No-Subscription Repository
109 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
111 As the name suggests, you do not need a subscription key to access
112 this repository. It can be used for testing and non-production
113 use. It is not recommended to use it on production servers, because these
114 packages are not always heavily tested and validated.
116 We recommend to configure this repository in ``/etc/apt/sources.list``.
118 .. code-block:: sources.list
119 :caption: File: ``/etc/apt/sources.list``
121 deb http://ftp.debian.org/debian buster main contrib
122 deb http://ftp.debian.org/debian buster-updates main contrib
124 # PBS pbs-no-subscription repository provided by proxmox.com,
125 # NOT recommended for production use
126 deb http://download.proxmox.com/debian/pbs buster pbs-no-subscription
129 deb http://security.debian.org/debian-security buster/updates main contrib
132 `Proxmox Backup`_ Beta Repository
133 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
135 During the public beta, there is a repository called ``pbstest``. This one
136 contains the latest packages and is heavily used by developers to test new
139 .. .. warning:: the ``pbstest`` repository should (as the name implies)
140 only be used to test new features or bug fixes.
142 You can configure this using ``/etc/apt/sources.list`` by adding the following
145 .. code-block:: sources.list
146 :caption: sources.list entry for ``pbstest``
148 deb http://download.proxmox.com/debian/pbs buster pbstest
150 If you installed Proxmox Backup Server from the official beta ISO you should
151 have this repository already configured in
152 ``/etc/apt/sources.list.d/pbstest-beta.list``