]>
Commit | Line | Data |
---|---|---|
58ea88c8 DM |
1 | .. _sysadmin_package_repositories: |
2 | ||
7391b4cf DM |
3 | Debian Package Repositories |
4 | --------------------------- | |
5 | ||
b2bfb468 TL |
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``. | |
7391b4cf DM |
16 | |
17 | .. code-block:: sources.list | |
18 | :caption: File: ``/etc/apt/sources.list`` | |
b2bfb468 | 19 | |
7391b4cf DM |
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 | ||
b2bfb468 | 26 | |
7391b4cf DM |
27 | .. FIXME for 7.0: change security update suite to bullseye-security |
28 | ||
b2bfb468 TL |
29 | In addition, you need a package repositories from Proxmox to get the backup |
30 | server updates. | |
7391b4cf | 31 | |
b2bfb468 TL |
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. | |
7391b4cf | 35 | |
e1897b36 TL |
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 | ||
b2bfb468 TL |
76 | .. comment |
77 | `Proxmox Backup`_ Enterprise Repository | |
78 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
7391b4cf | 79 | |
b2bfb468 TL |
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: | |
7391b4cf | 84 | |
b2bfb468 TL |
85 | .. note:: During the Proxmox Backup beta phase only one repository (pbstest) |
86 | will be available. | |
7391b4cf | 87 | |
b2bfb468 TL |
88 | .. code-block:: sources.list |
89 | :caption: File: ``/etc/apt/sources.list.d/pbs-enterprise.list`` | |
7391b4cf | 90 | |
b2bfb468 | 91 | deb https://enterprise.proxmox.com/debian/pbs buster pbs-enterprise |
7391b4cf | 92 | |
7391b4cf | 93 | |
b2bfb468 TL |
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). | |
7391b4cf | 97 | |
b2bfb468 TL |
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. | |
7391b4cf | 101 | |
b2bfb468 TL |
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. | |
7391b4cf | 106 | |
7391b4cf | 107 | |
b2bfb468 TL |
108 | `Proxmox Backup`_ No-Subscription Repository |
109 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
7391b4cf | 110 | |
b2bfb468 TL |
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. | |
7391b4cf | 115 | |
b2bfb468 | 116 | We recommend to configure this repository in ``/etc/apt/sources.list``. |
7391b4cf | 117 | |
b2bfb468 TL |
118 | .. code-block:: sources.list |
119 | :caption: File: ``/etc/apt/sources.list`` | |
7391b4cf | 120 | |
b2bfb468 TL |
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 | |
7391b4cf DM |
130 | |
131 | ||
b2bfb468 | 132 | `Proxmox Backup`_ Beta Repository |
7391b4cf DM |
133 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
134 | ||
b2bfb468 TL |
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 | |
7391b4cf DM |
137 | features. |
138 | ||
b2bfb468 | 139 | .. .. warning:: the ``pbstest`` repository should (as the name implies) |
4f3db187 | 140 | only be used to test new features or bug fixes. |
7391b4cf | 141 | |
b2bfb468 TL |
142 | You can configure this using ``/etc/apt/sources.list`` by adding the following |
143 | line: | |
7391b4cf DM |
144 | |
145 | .. code-block:: sources.list | |
146 | :caption: sources.list entry for ``pbstest`` | |
147 | ||
067fe514 | 148 | deb http://download.proxmox.com/debian/pbs buster pbstest |
7391b4cf | 149 | |
b2bfb468 TL |
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`` |