1 [[sysadmin_package_repositories]]
8 All Debian based systems use
9 http://en.wikipedia.org/wiki/Advanced_Packaging_Tool[APT] as package
10 management tool. The list of repositories is defined in
11 `/etc/apt/sources.list` and `.list` files found inside
12 `/etc/apt/sources.d/`. Updates can be installed directly using
13 `apt-get`, or via the GUI.
15 Apt `sources.list` files list one package repository per line, with
16 the most preferred source listed first. Empty lines are ignored, and a
17 `#` character anywhere on a line marks the remainder of that line as a
18 comment. The information available from the configured sources is
19 acquired by `apt-get update`.
21 .File `/etc/apt/sources.list`
23 deb http://ftp.debian.org/debian jessie main contrib
26 deb http://security.debian.org jessie/updates main contrib
29 In addition, {pve} provides three different package repositories.
31 {pve} Enterprise Repository
32 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
34 This is the default, stable and recommended repository, available for
35 all {pve} subscription users. It contains the most stable packages,
36 and is suitable for production use. The `pve-enterprise` repository is
39 .File `/etc/apt/sources.list.d/pve-enterprise.list`
41 deb https://enterprise.proxmox.com/debian jessie pve-enterprise
44 As soon as updates are available, the `root@pam` user is notified via
45 email about the available new packages. On the GUI, the change-log of
46 each package can be viewed (if available), showing all details of the
47 update. So you will never miss important security fixes.
49 Please note that and you need a valid subscription key to access this
50 repository. We offer different support levels, and you can find further
51 details at http://www.proxmox.com/en/proxmox-ve/pricing.
53 NOTE: You can disable this repository by commenting out the above line
54 using a `#` (at the start of the line). This prevents error messages
55 if you do not have a subscription key. Please configure the
56 `pve-no-subscription` repository in that case.
59 {pve} No-Subscription Repository
60 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
62 As the name suggests, you do not need a subscription key to access
63 this repository. It can be used for testing and non-production
64 use. Its not recommended to run on production servers, as these
65 packages are not always heavily tested and validated.
67 We recommend to configure this repository in `/etc/apt/sources.list`.
69 .File `/etc/apt/sources.list`
71 deb http://ftp.debian.org/debian jessie main contrib
73 # PVE pve-no-subscription repository provided by proxmox.com,
74 # NOT recommended for production use
75 deb http://download.proxmox.com/debian jessie pve-no-subscription
78 deb http://security.debian.org jessie/updates main contrib
83 ~~~~~~~~~~~~~~~~~~~~~~
85 Finally, there is a repository called `pvetest`. This one contains the
86 latest packages and is heavily used by developers to test new
87 features. As usual, you can configure this using
88 `/etc/apt/sources.list` by adding the following line:
90 .sources.list entry for `pvetest`
92 deb http://download.proxmox.com/debian jessie pvetest
95 WARNING: the `pvetest` repository should (as the name implies) only be used
96 for testing new features or bug fixes.
102 We use GnuPG to sign the `Release` files inside those repositories,
103 and APT uses that signatures to verify that all packages are from a
106 The key used for verification is already installed if you install from
107 our installation CD. If you install by other means, you can manually
108 download the key with:
110 # wget http://download.proxmox.com/debian/key.asc
112 Please verify the fingerprint afterwards:
115 # gpg --with-fingerprint key.asc
116 pub 1024D/9887F95A 2008-10-28 Proxmox Release Key <proxmox-release@proxmox.com>
117 Key fingerprint = BE25 7BAA 5D40 6D01 157D 323E C23A C7F4 9887 F95A
118 sub 2048g/A87A1B00 2008-10-28
121 If this shows the exact same fingerprint, you can add the key to the
122 list of trusted APT keys:
124 # apt-key add key.asc
129 // include note about older releases, but only for wiki
131 {pve} 3.x Repositories
132 ~~~~~~~~~~~~~~~~~~~~~~
134 {pve} 3.x is based on Debian 7.x (``wheezy''). Please note that this
135 release is out of date, and you should update your
136 installation. Nevertheless, we still provide access to those
137 repositories at our download servers.
139 [width="100%",cols="<d,3m",options="header"]
140 |===========================================================
141 |Repository | sources.list entry
142 |{pve} 3.x Enterprise |
143 deb https://enterprise.proxmox.com/debian wheezy pve-enterprise
144 |{pve} 3.x No-Subscription |
145 deb http://download.proxmox.com/debian wheezy pve-no-subscription
147 deb http://download.proxmox.com/debian wheezy pvetest
148 |===========================================================
150 NOTE: Apt `sources.list` configuration files are basically the same as
151 in newer 4.x versions - just replace `jessie` with `wheezy`.
153 Outdated: `stable` Repository `pve`
154 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
156 This repository is a leftover to easy the update to 3.1. It will not
157 get any updates after the release of 3.1. Therefore you need to remove
158 this repository after you upgraded to 3.1.
160 .File `/etc/apt/sources.list`
162 deb http://ftp.debian.org/debian wheezy main contrib
164 # PVE packages provided by proxmox.com - NO UPDATES after the initial release of 3.1
165 # deb http://download.proxmox.com/debian wheezy pve
168 deb http://security.debian.org/ wheezy/updates main contrib
172 Outdated: {pve} 2.x Repositories
173 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
175 {pve} 2.x is based on Debian 6.0 (``squeeze'') and outdated. Please
176 upgrade to latest version as soon as possible. In order to use the
177 stable `pve` 2.x repository, check your sources.list:
179 .File `/etc/apt/sources.list`
181 deb http://ftp.debian.org/debian squeeze main contrib
183 # PVE packages provided by proxmox.com
184 deb http://download.proxmox.com/debian squeeze pve
187 deb http://security.debian.org/ squeeze/updates main contrib
191 Outdated: {pve} VE 1.x Repositories
192 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
194 {pve} 1.x is based on Debian 5.0 (``lenny'') and very outdated. Please
195 upgrade to latest version as soon as possible.