How to Disable the Proxmox Enterprise Repository and Enable the No-Subscription Repository

Proxmox VE is an excellent open-source virtualization platform, but by default, it uses the Enterprise Repository, which requires a paid subscription. If you are using Proxmox VE without a subscription, you may encounter errors when trying to update or install packages.

To avoid these issues, you can disable the Enterprise Repository and enable the No-Subscription Repository instead. This guide walks you through the process step by step.

Why Disable the Enterprise Repository?

The Enterprise Repository is only accessible with a valid Proxmox subscription. If you attempt to update or install packages without a subscription, you may see errors like:

401 Unauthorized

Or:

Reinstallation of proxmox-widget-toolkit is not possible, it cannot be downloaded.

To prevent this, switching to the No-Subscription Repository is the best approach.

Step 1: Disable the Enterprise Repository

Open a terminal on your Proxmox server and run the following command to disable the enterprise repository:

echo "# deb https://enterprise.proxmox.com/debian/pve bookworm pve-enterprise" | tee /etc/apt/sources.list.d/pve-enterprise.list

This comments out the enterprise repository, preventing Proxmox from attempting to fetch updates from it.

Verify that the file has been updated by running:

cat /etc/apt/sources.list.d/pve-enterprise.list

You should see:

# deb https://enterprise.proxmox.com/debian/pve bookworm pve-enterprise

Step 2: Enable the No-Subscription Repository

Below command is used to add the Proxmox VE repository for the “no-subscription” version to your system’s repository list. It ensures that your system can access and download Proxmox packages, even without an enterprise subscription.

echo "deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription" | tee /etc/apt/sources.list.d/pve-install-repo.list

Below command is used to download and install the GPG key for the Proxmox repository on a system. It ensures that packages downloaded from the Proxmox repository can be verified as authentic and have not been tampered with.

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

This ensures that Proxmox pulls updates from the public repository instead.

Update the package list to reflect the changes:

apt update

Step 3: Verify the Repository Change

After updating, check that Proxmox is now using the No-Subscription Repository by running:

apt policy proxmox-widget-toolkit

You should see output similar to:

proxmox-widget-toolkit:
  Installed: (some version)
  Candidate: (same or newer version)
  Version table:
     (version) [http://download.proxmox.com/debian/pve bookworm pve-no-subscription]

This confirms that your Proxmox system is fetching updates from the correct repository.

Step 4: Reinstall Proxmox Widget Toolkit (If Needed)

If you previously tried to update proxmox-widget-toolkit but got an error due to the enterprise repository, you can now reinstall it with:

apt --reinstall install proxmox-widget-toolkit -y

After running this command, clear your browser cache to ensure that any UI changes take effect properly.

Conclusion