You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

283 lines
9.2KB

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