pve-package-repos.adoc

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