Add warning about pvetest
[pve-docs.git] / 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 list 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
87 WARNING: the `pvetest` repository should (as the name implies) only be used
88 for testing new features or bug fixes.
89