Proxmox VE ohne Subscription: kostenlose Repositories nutzen und Subscription-Hinweis ausblenden

Diese Anleitung beschreibt, wie ein Proxmox VE 9 System auf die kostenlosen Proxmox- und Debian-Repositories umgestellt wird. Zusätzlich wird erklärt, wie die Meldung „No valid subscription - You do not have a valid subscription for this server“ in der Weboberfläche ausgeblendet werden kann.

Wichtig: Die Umstellung auf das pve-no-subscription-Repository ist eine normale und saubere Repository-Konfiguration. Das Entfernen der Subscription-Meldung ist dagegen kein offiziell unterstützter Proxmox-Schalter, sondern ein lokaler Patch an einer JavaScript-Datei der Weboberfläche.

Diese Anleitung ist für Proxmox VE 9 auf Debian 13 Trixie geschrieben.

1. Ziel

Nach dieser Anleitung verwendet der Server:

Debian 13 Trixie Standard-Repositories
Debian Security Repository
Proxmox pve-no-subscription Repository
optional Proxmox Ceph no-subscription Repository

Nicht verwendet werden:

Proxmox Enterprise Repository
Proxmox Ceph Enterprise Repository

2. Aktuelle Proxmox-Version prüfen

pveversion
cat /etc/os-release

Erwartung bei Proxmox VE 9:

VERSION_CODENAME=trixie

3. Proxmox Enterprise Repository deaktivieren

Ohne gültige Subscription erzeugt das Enterprise-Repository Fehler bei apt update. Deshalb wird es deaktiviert.

Datei öffnen:

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

Falls die Datei existiert, sollte der Eintrag entweder entfernt oder deaktiviert werden.

Empfohlene Variante: Enabled: no ergänzen:

Types: deb
URIs: https://enterprise.proxmox.com/debian/pve
Suites: trixie
Components: pve-enterprise
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
Enabled: no

Falls die Datei nicht existiert, ist das ebenfalls in Ordnung. Dann ist das Enterprise-Repository wahrscheinlich nicht aktiv.

4. Kostenloses Proxmox Repository einrichten

Datei erstellen oder bearbeiten:

nano /etc/apt/sources.list.d/proxmox.sources

Inhalt:

Types: deb
URIs: http://download.proxmox.com/debian/pve
Suites: trixie
Components: pve-no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg

Das Repository pve-no-subscription benötigt keinen Subscription-Key. Es ist für Homelab, Testsysteme und nicht-produktive Systeme geeignet.

5. Debian Repositories prüfen

Proxmox benötigt zusätzlich weiterhin gültige Debian-Basis-Repositories. Bei Debian 13 wird bevorzugt das Deb822-Format verwendet.

Datei prüfen:

nano /etc/apt/sources.list.d/debian.sources

Beispiel für Debian 13 Trixie:

Types: deb
URIs: http://deb.debian.org/debian/
Suites: trixie trixie-updates
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Types: deb
URIs: http://security.debian.org/debian-security/
Suites: trixie-security
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Hinweis: Keine Debian-Repositories entfernen, nur weil Proxmox installiert ist. Proxmox basiert auf Debian und benötigt die Debian-Repositories weiterhin.

6. Optional: Debian Backports

Backports sind für Proxmox normalerweise nicht zwingend nötig. Wenn sie verwendet werden, sollten sie bewusst gesetzt sein.

Beispiel:

Types: deb
URIs: http://deb.debian.org/debian/
Suites: trixie-backports
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Backports nicht blind für alles verwenden. Pakete aus Backports sollten gezielt installiert werden.

7. Optional: Proxmox Ceph No-Subscription Repository

Wenn Ceph auf dem Proxmox-Cluster verwendet werden soll, kann das kostenlose Ceph-Repository eingerichtet werden. Bei Proxmox VE 9 ist Ceph Squid relevant.

Datei erstellen oder bearbeiten:

nano /etc/apt/sources.list.d/ceph.sources

Inhalt für Ceph Squid ohne Subscription:

Types: deb
URIs: http://download.proxmox.com/debian/ceph-squid
Suites: trixie
Components: no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg

Falls ein Enterprise-Ceph-Repository vorhanden ist, sollte es deaktiviert werden:

Types: deb
URIs: https://enterprise.proxmox.com/debian/ceph-squid
Suites: trixie
Components: enterprise
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
Enabled: no

8. Paketlisten aktualisieren

apt update

Wenn alles korrekt ist, sollten keine Fehler wie diese erscheinen:

401 Unauthorized
403 Forbidden
NO_PUBKEY
The repository is not signed
does not have a Release file

Ein Hinweis wie dieser ist bei aktivierter i386-Architektur nicht kritisch:

pve-no-subscription/binary-i386/Packages wird übersprungen, da das Depot die Architektur i386 nicht unterstützt.

Proxmox stellt keine i386-Pakete bereit. Wenn keine 32-bit-Pakete benötigt werden, kann die Architektur später entfernt werden.

9. Upgrade ausführen

apt full-upgrade

Danach prüfen:

dpkg --audit
pveversion
uname -r

10. Subscription-Meldung in der Weboberfläche ausblenden

Wichtig: Das ist kein offiziell unterstützter Proxmox-Schalter. Dabei wird eine JavaScript-Datei der Proxmox-Weboberfläche lokal geändert. Nach Updates des Pakets proxmox-widget-toolkit kann die Meldung wieder erscheinen.

Betroffene Datei:

/usr/share/javascript/proxmox-widget-toolkit/proxmoxlib.js

Zuerst Backup erstellen:

cp -a /usr/share/javascript/proxmox-widget-toolkit/proxmoxlib.js /usr/share/javascript/proxmox-widget-toolkit/proxmoxlib.js.bak

Datei öffnen:

nano /usr/share/javascript/proxmox-widget-toolkit/proxmoxlib.js

In Nano mit Strg + W nach folgendem Text suchen:

No valid subscription

In der Nähe befindet sich eine Abfrage ähnlich zu:

res.data.status.toLowerCase() !== 'active'

Diese Bedingung so ändern, dass sie nie wahr wird:

false

Das Ergebnis sieht dann sinngemäß so aus:

if (
    res === undefined ||
    !res ||
    false
) {
    Ext.Msg.show({
        title: gettext('No valid subscription'),
        ...
    });
}

Dadurch bleibt der Code grundsätzlich erhalten, aber die Meldung wird nicht mehr ausgelöst. Ja, das ist hässlich. JavaScript-Patching in Vendor-Dateien ist immer ein bisschen wie Tape auf einer Warnlampe.

11. Proxmox Webproxy neu starten

systemctl restart pveproxy

Danach Browser-Cache leeren oder die Proxmox-Weboberfläche in einem privaten Fenster öffnen.

Weboberfläche:

https://SERVER-IP:8006/

12. Änderung rückgängig machen

Wenn die Weboberfläche Probleme macht oder die Änderung zurückgenommen werden soll:

cp -a /usr/share/javascript/proxmox-widget-toolkit/proxmoxlib.js.bak /usr/share/javascript/proxmox-widget-toolkit/proxmoxlib.js
systemctl restart pveproxy

Alternativ kann das Paket neu installiert werden:

apt install --reinstall proxmox-widget-toolkit
systemctl restart pveproxy

13. Nach Updates prüfen

Wenn das Paket proxmox-widget-toolkit aktualisiert wird, kann die Datei proxmoxlib.js überschrieben werden. Dann erscheint die Subscription-Meldung wieder.

Nach Updates prüfen:

apt list --upgradable
dpkg -l proxmox-widget-toolkit

Falls die Meldung wieder erscheint, den Patch erneut anwenden.

14. Empfohlene Repository-Zielstruktur

Für ein Proxmox VE 9 Homelab ohne Subscription:

/etc/apt/sources.list.d/debian.sources
/etc/apt/sources.list.d/proxmox.sources

Optional bei Ceph:

/etc/apt/sources.list.d/ceph.sources

Nicht aktiv ohne Subscription:

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

Enterprise-Dateien können vorhanden sein, sollten aber deaktiviert sein:

Enabled: no

15. Kontrollbefehle

apt update
apt full-upgrade
dpkg --audit
pveversion
systemctl status pveproxy --no-pager
systemctl status pvedaemon --no-pager
systemctl status pve-cluster --no-pager

Erwartung:

apt update läuft ohne Enterprise-Fehler durch.
pveproxy läuft.
Die Proxmox-Weboberfläche ist erreichbar.
Die Subscription-Meldung erscheint nach dem Patch nicht mehr.

16. Zusammenfassung

Das Proxmox Enterprise Repository wurde deaktiviert.
Das kostenlose pve-no-subscription Repository wurde aktiviert.
Debian 13 Trixie Repositories bleiben aktiv.
Optional wurde das kostenlose Ceph Repository aktiviert.
Die Subscription-Meldung wurde durch einen lokalen Patch in proxmoxlib.js ausgeblendet.
Der Patch kann nach Updates von proxmox-widget-toolkit erneut nötig sein.