docs/package-repositories.rst

   1 .. _sysadmin_package_repositories:
   2
   3 Debian Package Repositories
   4 ---------------------------
   5
   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.
  10
  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
  15 update``.
  16
  17 .. code-block:: sources.list
  18   :caption: File: ``/etc/apt/sources.list``
  19
  20   deb http://ftp.debian.org/debian buster main contrib
  21   deb http://ftp.debian.org/debian buster-updates main contrib
  22
  23   # security updates
  24   deb http://security.debian.org/debian-security buster/updates main contrib
  25
  26
  27 .. FIXME for 7.0: change security update suite to bullseye-security
  28
  29 In addition, you need a package repositories from Proxmox to get the backup
  30 server updates.
  31
  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.
  35
  36 SecureApt
  37 ~~~~~~~~~
  38
  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.
  41
  42 If you install Proxmox Backup Server from an official ISO image, the key for
  43 verification is already installed.
  44
  45 If you install Proxmox Backup Server on top of Debian, download and install the
  46 key with the following commands:
  47
  48 .. code-block:: console
  49
  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
  51
  52 Verify the SHA512 checksum afterwards with:
  53
  54 .. code-block:: console
  55
  56  # sha512sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
  57
  58 The output should be:
  59
  60 .. code-block:: console
  61
  62  acca6f416917e8e11490a08a1e2842d500b3a5d9f322c6319db0927b2901c3eae23cfb5cd5df6facf2b57399d3cfa52ad7769ebdd75d9b204549ca147da52626 /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
  63
  64 and the md5sum:
  65
  66 .. code-block:: console
  67
  68  # md5sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
  69
  70 Here, the output should be:
  71
  72 .. code-block:: console
  73
  74  f3f6c5a3a67baf38ad178e5ff1ee270c /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
  75
  76 .. comment
  77     `Proxmox Backup`_ Enterprise Repository
  78     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  79
  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
  83     enabled by default:
  84
  85     .. note:: During the Proxmox Backup beta phase only one repository (pbstest)
  86      will be available.
  87
  88     .. code-block:: sources.list
  89       :caption: File: ``/etc/apt/sources.list.d/pbs-enterprise.list``
  90
  91       deb https://enterprise.proxmox.com/debian/pbs buster pbs-enterprise
  92
  93
  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).
  97
  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.
 101
 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.
 106
 107
 108     `Proxmox Backup`_ No-Subscription Repository
 109     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 110
 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.
 115
 116     We recommend to configure this repository in ``/etc/apt/sources.list``.
 117
 118     .. code-block:: sources.list
 119       :caption: File: ``/etc/apt/sources.list``
 120
 121       deb http://ftp.debian.org/debian buster main contrib
 122       deb http://ftp.debian.org/debian buster-updates main contrib
 123
 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
 127
 128       # security updates
 129       deb http://security.debian.org/debian-security buster/updates main contrib
 130
 131
 132 `Proxmox Backup`_ Beta Repository
 133 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 134
 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
 137 features.
 138
 139 ..  .. warning:: the ``pbstest`` repository should (as the name implies)
 140   only be used to test new features or bug fixes.
 141
 142 You can configure this using ``/etc/apt/sources.list`` by adding the following
 143 line:
 144
 145 .. code-block:: sources.list
 146   :caption: sources.list entry for ``pbstest``
 147
 148   deb http://download.proxmox.com/debian/pbs buster pbstest
 149
 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``