pve-package-repos.adoc

   1 Package Repositories
   2 --------------------
   3
   4 All Debian based systems use
   5 http://en.wikipedia.org/wiki/Advanced_Packaging_Tool[APT] as package
   6 management tool. The list of repositories is defined in
   7 '/etc/apt/sources.list' and '.list' files found inside
   8 '/etc/apt/sources.d/'. Updates can be installed directly using
   9 'apt-get', or via the GUI.
  10
  11 Apt 'sources.list' files lists one package repository per line, with
  12 the most preferred source listed first. Empty lines are ignored, and a
  13 '#' character anywhere on a line marks the remainder of that line as a
  14 comment. The information available from the configured sources is
  15 acquired by 'apt-get update'.
  16
  17 .File '/etc/apt/sources.list'
  18 ----
  19 deb http://ftp.debian.org/debian jessie main contrib
  20
  21 # security updates
  22 deb http://security.debian.org jessie/updates main contrib
  23 ----
  24
  25 In addition, {pve} provides three different package repositories.
  26
  27 {pve} Enterprise Repository
  28 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  29
  30 This is the default, stable and recommended repository, available for
  31 all {pve} subscription users. It contains the most stable packages,
  32 and is suitable for production use. You need a valid subscription key
  33 to access this repository. The `pve-enterprise` repository is enabled
  34 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 NOTE: You can disable this repository by commenting out the above line
  42 using a '#' (at the start of the line). This prevents error messages
  43 if you do not have a subscription key. Please configure the
  44 `pve-no-subscription` repository in that case.
  45
  46 As soon as updates are available, the `root@pam` user is notified via
  47 email about the available new packages. On the GUI, the change-log of
  48 each package can be viewed (if available), showing all details of the
  49 update. So you will never miss important security fixes.
  50
  51 {pve} No-Subscription Repository
  52 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  53
  54 As the name suggests, you do not need a subscription key to access
  55 this repository. It can be used for testing and non-production
  56 use. Its not recommended to run on production servers, as these
  57 packages are not always heavily tested and validated.
  58
  59 We recommend to configure this repository in '/etc/apt/sources.list'.
  60
  61 .File '/etc/apt/sources.list'
  62 ----
  63 deb http://ftp.debian.org/debian jessie main contrib
  64
  65 # PVE pve-no-subscription repository provided by proxmox.com,
  66 # NOT recommended for production use
  67 deb http://download.proxmox.com/debian jessie pve-no-subscription
  68
  69 # security updates
  70 deb http://security.debian.org jessie/updates main contrib
  71 ----
  72
  73
  74 {pve} Test Repository
  75 ~~~~~~~~~~~~~~~~~~~~~~
  76
  77 Finally, there is a repository called `pvetest`. This one contains the
  78 latest packages and is heavily used by developers to test new
  79 features. As usual, you can configure this using
  80 '/etc/apt/sources.list' by adding the following line:
  81
  82 .sources.list entry for `pvetest`
  83 ----
  84 deb http://download.proxmox.com/debian jessie pvetest
  85 ----
  86