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. You need a valid subscription key
  34 to access this repository. The `pve-enterprise` repository is enabled
  35 by default:
  36
  37 .File '/etc/apt/sources.list.d/pve-enterprise.list'
  38 ----
  39 deb https://enterprise.proxmox.com/debian jessie pve-enterprise
  40 ----
  41
  42 NOTE: You can disable this repository by commenting out the above line
  43 using a '#' (at the start of the line). This prevents error messages
  44 if you do not have a subscription key. Please configure the
  45 `pve-no-subscription` repository in that case.
  46
  47 As soon as updates are available, the `root@pam` user is notified via
  48 email about the available new packages. On the GUI, the change-log of
  49 each package can be viewed (if available), showing all details of the
  50 update. So you will never miss important security fixes.
  51
  52 {pve} No-Subscription Repository
  53 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  54
  55 As the name suggests, you do not need a subscription key to access
  56 this repository. It can be used for testing and non-production
  57 use. Its not recommended to run on production servers, as these
  58 packages are not always heavily tested and validated.
  59
  60 We recommend to configure this repository in '/etc/apt/sources.list'.
  61
  62 .File '/etc/apt/sources.list'
  63 ----
  64 deb http://ftp.debian.org/debian jessie main contrib
  65
  66 # PVE pve-no-subscription repository provided by proxmox.com,
  67 # NOT recommended for production use
  68 deb http://download.proxmox.com/debian jessie pve-no-subscription
  69
  70 # security updates
  71 deb http://security.debian.org jessie/updates main contrib
  72 ----
  73
  74
  75 {pve} Test Repository
  76 ~~~~~~~~~~~~~~~~~~~~~~
  77
  78 Finally, there is a repository called `pvetest`. This one contains the
  79 latest packages and is heavily used by developers to test new
  80 features. As usual, you can configure this using
  81 '/etc/apt/sources.list' by adding the following line:
  82
  83 .sources.list entry for `pvetest`
  84 ----
  85 deb http://download.proxmox.com/debian jessie pvetest
  86 ----
  87
  88 WARNING: the `pvetest` repository should (as the name implies) only be used
  89 for testing new features or bug fixes.
  90