Difference between revisions of "Package Repositories"

From Proxmox VE
Jump to navigation Jump to search
Line 5: Line 5:
 
<pvehide>
 
<pvehide>
 
Proxmox VE uses APT as its
 
Proxmox VE uses APT as its
package management tool like any other Debian-based system. Repositories are
+
package management tool like any other Debian-based system.
defined in the file /etc/apt/sources.list and in .list files placed in
+
Repositories in Proxmox VE
/etc/apt/sources.list.d/.
+
Repositories are a collection of software packages, they can be used to install
Each line defines a package repository. The preferred source must come first.
+
new software, but are also important to get new updates.
Empty lines are ignored. A # character anywhere on a line marks the remainder
+
You need valid Debian and Proxmox repositories to get the latest
of that line as a comment. The available packages from a repository are acquired
+
security updates, bug fixes and new features.
by running apt-get update. Updates can be installed directly using apt-get,
+
APT Repositories are defined in the file /etc/apt/sources.list and in .list
or via the GUI.
+
files placed in /etc/apt/sources.list.d/.
 +
Repository Management
 +
Since Proxmox VE 7.0 you can check the repository state in the web interface.
 +
The node summary panel shows a high level status overview, while the separate
 +
Repository panel shows in-depth status and list of all configured
 +
repositories.
 +
Basic repository management, for example, activating or deactivating a
 +
repository, is also supported.
 +
Sources.list
 +
In a sources.list file, each line defines a package repository. The preferred
 +
source must come first. Empty lines are ignored. A # character anywhere on a
 +
line marks the remainder of that line as a comment. The available packages from
 +
a repository are acquired by running apt-get update. Updates can be installed
 +
directly using apt-get, or via the GUI (Node &#8594; Updates).
 
File /etc/apt/sources.list
 
File /etc/apt/sources.list
deb http://ftp.debian.org/debian buster main contrib
+
deb http://ftp.debian.org/debian bullseye main contrib
deb http://ftp.debian.org/debian buster-updates main contrib
+
deb http://ftp.debian.org/debian bullseye-updates main contrib
 
# security updates
 
# security updates
deb http://security.debian.org/debian-security buster/updates main contrib
+
deb http://security.debian.org/debian-security bullseye-security main contrib
Proxmox VE additionally provides three different package repositories.
+
Proxmox VE provides three different package repositories.
 
Proxmox VE Enterprise Repository
 
Proxmox VE Enterprise Repository
 
This is the default, stable, and recommended repository, available for all Proxmox VE
 
This is the default, stable, and recommended repository, available for all Proxmox VE
Line 24: Line 37:
 
production use. The pve-enterprise repository is enabled by default:
 
production use. The pve-enterprise repository is enabled by default:
 
File /etc/apt/sources.list.d/pve-enterprise.list
 
File /etc/apt/sources.list.d/pve-enterprise.list
deb https://enterprise.proxmox.com/debian/pve buster pve-enterprise
+
deb https://enterprise.proxmox.com/debian/pve bullseye pve-enterprise
 
The root@pam user is notified via email about available updates. Click the
 
The root@pam user is notified via email about available updates. Click the
 
Changelog button in the GUI to see more details about the selected update.
 
Changelog button in the GUI to see more details about the selected update.
Line 40: Line 53:
 
We recommend to configure this repository in /etc/apt/sources.list.
 
We recommend to configure this repository in /etc/apt/sources.list.
 
File /etc/apt/sources.list
 
File /etc/apt/sources.list
deb http://ftp.debian.org/debian buster main contrib
+
deb http://ftp.debian.org/debian bullseye main contrib
deb http://ftp.debian.org/debian buster-updates main contrib
+
deb http://ftp.debian.org/debian bullseye-updates main contrib
 
# PVE pve-no-subscription repository provided by proxmox.com,
 
# PVE pve-no-subscription repository provided by proxmox.com,
 
# NOT recommended for production use
 
# NOT recommended for production use
deb http://download.proxmox.com/debian/pve buster pve-no-subscription
+
deb http://download.proxmox.com/debian/pve bullseye pve-no-subscription
 
# security updates
 
# security updates
deb http://security.debian.org/debian-security buster/updates main contrib
+
deb http://security.debian.org/debian-security bullseye-security main contrib
 
Proxmox VE Test Repository
 
Proxmox VE Test Repository
 
This repository contains the latest packages and is primarily used by developers
 
This repository contains the latest packages and is primarily used by developers
Line 52: Line 65:
 
etc/apt/sources.list:
 
etc/apt/sources.list:
 
sources.list entry for pvetest
 
sources.list entry for pvetest
deb http://download.proxmox.com/debian/pve buster pvetest
+
deb http://download.proxmox.com/debian/pve bullseye pvetest
 
The pvetest repository should (as the name implies) only be used for
 
The pvetest repository should (as the name implies) only be used for
 
testing new features or bug fixes.
 
testing new features or bug fixes.
Ceph Octopus Repository
+
Ceph Pacific Repository
Ceph Octopus (15.2) was declared stable with Proxmox VE 6.3 and is the most
+
Ceph Pacific (16.2) was declared stable with Proxmox VE 7.0.
recent Ceph release supported. It will continue to get updates for the
+
This repository holds the main Proxmox VE Ceph Pacific packages. They are suitable
remaining life time of the 6.x release.
 
This repository holds the main Proxmox VE Ceph Octopus packages. They are suitable
 
 
for production. Use this repository if you run the Ceph client or a full Ceph
 
for production. Use this repository if you run the Ceph client or a full Ceph
 
cluster on Proxmox VE.
 
cluster on Proxmox VE.
 
File /etc/apt/sources.list.d/ceph.list
 
File /etc/apt/sources.list.d/ceph.list
deb http://download.proxmox.com/debian/ceph-octopus buster main
+
deb http://download.proxmox.com/debian/ceph-pacific bullseye main
Ceph Octopus Test Repository
+
Ceph Pacific Test Repository
This Ceph repository contains the Ceph packages before they are moved to the
+
This Ceph repository contains the Ceph Pacific packages before they are moved
main repository. It is used to test new Ceph releases on Proxmox VE.
+
to the main repository. It is used to test new Ceph releases on Proxmox VE.
 
File /etc/apt/sources.list.d/ceph.list
 
File /etc/apt/sources.list.d/ceph.list
deb http://download.proxmox.com/debian/ceph-octopus buster test
+
deb http://download.proxmox.com/debian/ceph-pacific bullseye test
Ceph Nautilus Repository
+
Ceph Octopus Repository
Ceph Nautlius (14.2) is the older supported Ceph version, introduced with
+
Ceph Octopus (15.2) was declared stable with Proxmox VE 6.3 it will continue
Proxmox VE 6.0. It will continue to get updates until end of Q2 2021, so you will
+
to get updates for the remaining life time of the 6.x release
eventually need to
+
and also for Proxmox VE 7.x until Ceph Octopus upstream EOL (~ 2022-07).
upgrade to Ceph Octopus.
+
This repository holds the main Proxmox VE Ceph Octopus packages. They are suitable
This repository holds the main Proxmox VE Ceph Nautilus packages. They are suitable
 
 
for production. Use this repository if you run the Ceph client or a full Ceph
 
for production. Use this repository if you run the Ceph client or a full Ceph
 
cluster on Proxmox VE.
 
cluster on Proxmox VE.
 
File /etc/apt/sources.list.d/ceph.list
 
File /etc/apt/sources.list.d/ceph.list
deb http://download.proxmox.com/debian/ceph-nautilus buster main
+
deb http://download.proxmox.com/debian/ceph-octopus bullseye main
Ceph Nautilus Test Repository
+
Note that on an older Proxmox VE 6.x you need to change bullseye to buster in
 +
the repository specification above.
 +
Ceph Octopus Test Repository
 
This Ceph repository contains the Ceph packages before they are moved to the
 
This Ceph repository contains the Ceph packages before they are moved to the
 
main repository. It is used to test new Ceph releases on Proxmox VE.
 
main repository. It is used to test new Ceph releases on Proxmox VE.
 
File /etc/apt/sources.list.d/ceph.list
 
File /etc/apt/sources.list.d/ceph.list
deb http://download.proxmox.com/debian/ceph-nautilus buster test
+
deb http://download.proxmox.com/debian/ceph-octopus bullseye test
Proxmox VE Ceph Luminous Repository For Upgrade
 
If Ceph is deployed this repository is needed for the upgrade from Proxmox VE 5.x to
 
Proxmox VE 6.0. It provides packages for the older Ceph Luminous release for Proxmox VE
 
6.0.
 
The Upgrade 5.x to 6.0
 
document explains how to use this repository in detail.
 
File /etc/apt/sources.list.d/ceph.list
 
deb http://download.proxmox.com/debian/ceph-luminous buster main
 
 
SecureApt
 
SecureApt
 
The Release files in the repositories are signed with GnuPG. APT is using
 
The Release files in the repositories are signed with GnuPG. APT is using
Line 99: Line 103:
 
If you install Proxmox VE on top of Debian, download and install
 
If you install Proxmox VE on top of Debian, download and install
 
the key with the following commands:
 
the key with the following commands:
  # wget http://download.proxmox.com/debian/proxmox-ve-release-6.x.gpg -O /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
+
  # wget https://enterprise.proxmox.com/debian/proxmox-release-bullseye.gpg -O /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
 
Verify the checksum afterwards with:
 
Verify the checksum afterwards with:
# sha512sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
+
# sha512sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
 
The output should be:
 
The output should be:
acca6f416917e8e11490a08a1e2842d500b3a5d9f322c6319db0927b2901c3eae23cfb5cd5df6facf2b57399d3cfa52ad7769ebdd75d9b204549ca147da52626 /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
+
7fb03ec8a1675723d2853b84aa4fdb49a46a3bb72b9951361488bfd19b29aab0a789a4f8c7406e71a69aabbc727c936d3549731c4659ffa1a08f44db8fdcebfa /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
 
or:
 
or:
# md5sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
+
# md5sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
 
The output should be:
 
The output should be:
f3f6c5a3a67baf38ad178e5ff1ee270c /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
+
bcc35c7173e0845c0d6ad6470b70f50e /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
 +
Proxmox VE 6.x Repositories
 +
Proxmox VE 6.x is based on Debian 10.x (&#8220;buster&#8221;). Please note that this release is
 +
out of date. Existing installations should be updated. Nevertheless access to
 +
these repositories is still provided.
 +
Repository
 +
sources.list entry
 +
Proxmox VE 6.x Enterprise
 +
deb https://enterprise.proxmox.com/debian buster pve-enterprise
 +
Proxmox VE 6.x No-Subscription
 +
deb http://download.proxmox.com/debian buster pve-no-subscription
 +
Proxmox VE 6.x Test
 +
deb http://download.proxmox.com/debian buster pvetest
 
Proxmox VE 5.x Repositories
 
Proxmox VE 5.x Repositories
 
Proxmox VE 5.x is based on Debian 9.x (&#8220;stretch&#8221;). Please note that this release is
 
Proxmox VE 5.x is based on Debian 9.x (&#8220;stretch&#8221;). Please note that this release is

Revision as of 12:56, 6 July 2021

Proxmox VE uses APT as its package management tool like any other Debian-based system.

Repositories in Proxmox VE

Repositories are a collection of software packages, they can be used to install new software, but are also important to get new updates.

Note You need valid Debian and Proxmox repositories to get the latest security updates, bug fixes and new features.

APT Repositories are defined in the file /etc/apt/sources.list and in .list files placed in /etc/apt/sources.list.d/.

Repository Management

screenshot/gui-node-repositories.png

Since Proxmox VE 7.0 you can check the repository state in the web interface. The node summary panel shows a high level status overview, while the separate Repository panel shows in-depth status and list of all configured repositories.

Basic repository management, for example, activating or deactivating a repository, is also supported.

Sources.list

In a sources.list file, each line defines a package repository. The preferred source must come first. Empty lines are ignored. A # character anywhere on a line marks the remainder of that line as a comment. The available packages from a repository are acquired by running apt-get update. Updates can be installed directly using apt-get, or via the GUI (Node → Updates).

File /etc/apt/sources.list
deb http://ftp.debian.org/debian bullseye main contrib
deb http://ftp.debian.org/debian bullseye-updates main contrib

# security updates
deb http://security.debian.org/debian-security bullseye-security main contrib

Proxmox VE provides three different package repositories.

Proxmox VE Enterprise Repository

This is the default, stable, and recommended repository, available for all Proxmox VE subscription users. It contains the most stable packages and is suitable for production use. The pve-enterprise repository is enabled by default:

File /etc/apt/sources.list.d/pve-enterprise.list
deb https://enterprise.proxmox.com/debian/pve bullseye pve-enterprise

The root@pam user is notified via email about available updates. Click the Changelog button in the GUI to see more details about the selected update.

You need a valid subscription key to access the pve-enterprise repository. Different support levels are available. Further details can be found at https://www.proxmox.com/en/proxmox-ve/pricing.

Note You can disable this repository by commenting out the above line using a # (at the start of the line). This prevents error messages if you do not have a subscription key. Please configure the pve-no-subscription repository in that case.

Proxmox VE No-Subscription Repository

This is the recommended repository for testing and non-production use. Its packages are not as heavily tested and validated. You don’t need a subscription key to access the pve-no-subscription repository.

We recommend to configure this repository in /etc/apt/sources.list.

File /etc/apt/sources.list
deb http://ftp.debian.org/debian bullseye main contrib
deb http://ftp.debian.org/debian bullseye-updates main contrib

# PVE pve-no-subscription repository provided by proxmox.com,
# NOT recommended for production use
deb http://download.proxmox.com/debian/pve bullseye pve-no-subscription

# security updates
deb http://security.debian.org/debian-security bullseye-security main contrib

Proxmox VE Test Repository

This repository contains the latest packages and is primarily used by developers to test new features. To configure it, add the following line to etc/apt/sources.list:

sources.list entry for pvetest
deb http://download.proxmox.com/debian/pve bullseye pvetest
Warning The pvetest repository should (as the name implies) only be used for testing new features or bug fixes.

Ceph Pacific Repository

Note Ceph Pacific (16.2) was declared stable with Proxmox VE 7.0.

This repository holds the main Proxmox VE Ceph Pacific packages. They are suitable for production. Use this repository if you run the Ceph client or a full Ceph cluster on Proxmox VE.

File /etc/apt/sources.list.d/ceph.list
deb http://download.proxmox.com/debian/ceph-pacific bullseye main

Ceph Pacific Test Repository

This Ceph repository contains the Ceph Pacific packages before they are moved to the main repository. It is used to test new Ceph releases on Proxmox VE.

File /etc/apt/sources.list.d/ceph.list
deb http://download.proxmox.com/debian/ceph-pacific bullseye test

Ceph Octopus Repository

Note Ceph Octopus (15.2) was declared stable with Proxmox VE 6.3 it will continue to get updates for the remaining life time of the 6.x release and also for Proxmox VE 7.x until Ceph Octopus upstream EOL (~ 2022-07).

This repository holds the main Proxmox VE Ceph Octopus packages. They are suitable for production. Use this repository if you run the Ceph client or a full Ceph cluster on Proxmox VE.

File /etc/apt/sources.list.d/ceph.list
deb http://download.proxmox.com/debian/ceph-octopus bullseye main

Note that on an older Proxmox VE 6.x you need to change bullseye to buster in the repository specification above.

Ceph Octopus Test Repository

This Ceph repository contains the Ceph packages before they are moved to the main repository. It is used to test new Ceph releases on Proxmox VE.

File /etc/apt/sources.list.d/ceph.list
deb http://download.proxmox.com/debian/ceph-octopus bullseye test

SecureApt

The Release files in the repositories are signed with GnuPG. APT is using these signatures to verify that all packages are from a trusted source.

If you install Proxmox VE from an official ISO image, the key for verification is already installed.

If you install Proxmox VE on top of Debian, download and install the key with the following commands:

 # wget https://enterprise.proxmox.com/debian/proxmox-release-bullseye.gpg -O /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg

Verify the checksum afterwards with the sha512sum CLI tool:

# sha512sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
7fb03ec8a1675723d2853b84aa4fdb49a46a3bb72b9951361488bfd19b29aab0a789a4f8c7406e71a69aabbc727c936d3549731c4659ffa1a08f44db8fdcebfa /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg

or the md5sum CLI tool:

# md5sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
bcc35c7173e0845c0d6ad6470b70f50e /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg

Proxmox VE 6.x Repositories

Proxmox VE 6.x is based on Debian 10.x (“buster”). Please note that this release is out of date. Existing installations should be updated. Nevertheless access to these repositories is still provided.

Repository sources.list entry

Proxmox VE 6.x Enterprise

deb https://enterprise.proxmox.com/debian/pve buster pve-enterprise

Proxmox VE 6.x No-Subscription

deb http://download.proxmox.com/debian/pve buster pve-no-subscription

Proxmox VE 6.x Test

deb http://download.proxmox.com/debian/pve buster pvetest

Proxmox VE 5.x Repositories

Proxmox VE 5.x is based on Debian 9.x (“stretch”). Please note that this release is out of date. Existing installations should be updated. Nevertheless access to these repositories is still provided.

Repository sources.list entry

Proxmox VE 5.x Enterprise

deb https://enterprise.proxmox.com/debian/pve stretch pve-enterprise

Proxmox VE 5.x No-Subscription

deb http://download.proxmox.com/debian/pve stretch pve-no-subscription

Proxmox VE 5.x Test

deb http://download.proxmox.com/debian/pve stretch pvetest

Proxmox VE 4.x Repositories

Proxmox VE 4.x is based on Debian 8.x (“jessie”). Please note that this release is out of date. Existing installations should be updated. Nevertheless access to these repositories is still provided.

Repository sources.list entry

Proxmox VE 4.x Enterprise

deb https://enterprise.proxmox.com/debian/pve jessie pve-enterprise

Proxmox VE 4.x No-Subscription

deb http://download.proxmox.com/debian/pve jessie pve-no-subscription

Proxmox VE 4.x Test

deb http://download.proxmox.com/debian/pve jessie pvetest

Proxmox VE 3.x Repositories

Proxmox VE 3.x is based on Debian 7.x (“wheezy”). Please note that this release is out of date. Existing installations should be updated. Nevertheless access to these repositories is still provided.

Repository sources.list entry

Proxmox VE 3.x Enterprise

deb https://enterprise.proxmox.com/debian/pve wheezy pve-enterprise

Proxmox VE 3.x No-Subscription

deb http://download.proxmox.com/debian/pve wheezy pve-no-subscription

Proxmox VE 3.x Test

deb http://download.proxmox.com/debian/pve wheezy pvetest

Outdated: stable Repository pve

This repository is a leftover to ease the update to 3.1. It will not get any updates after the release of 3.1. Therefore the repository needs to be removed after the upgrade to 3.1.

File /etc/apt/sources.list
deb http://ftp.debian.org/debian wheezy main contrib

# PVE packages provided by proxmox.com - NO UPDATES after the initial release of 3.1
# deb http://download.proxmox.com/debian wheezy pve

# security updates
deb http://security.debian.org/ wheezy/updates main contrib

Outdated: Proxmox VE 2.x Repositories

Proxmox VE 2.x is based on Debian 6.0 (“squeeze”) and outdated. Please upgrade to the latest version as soon as possible. In order to use the stable pve 2.x repository, check your sources.list:

File /etc/apt/sources.list
deb http://ftp.debian.org/debian squeeze main contrib

# PVE packages provided by proxmox.com
deb http://download.proxmox.com/debian squeeze pve

# security updates
deb http://security.debian.org/ squeeze/updates main contrib

Outdated: Proxmox VE VE 1.x Repositories

Proxmox VE 1.x is based on Debian 5.0 (“lenny”) and very outdated. Please upgrade to latest version as soon as possible.