Proxmox-Custom-Themes: Was übersteht Updates wirklich?

Ja, Sie können Proxmox wie eine Cyberpunk-Kommandozentrale, eine UniFi-Konsole, Dracula, Tokyo Night oder fast alles aussehen lassen, was CSS ermöglicht. Denken Sie nur daran, dass benutzerdefinierte Themes keine offiziell unterstützte Proxmox-Funktion sind, und das wird spürbar, sobald der erste Reiz verflogen ist.

Ein eigenes Theme wirkt harmlos, weil es Farben, Hintergründe, Diagramme, Logos und Typografie anpasst, während Storage und Netzwerkkonfiguration unangetastet bleiben. Viele serverseitige Themes arbeiten jedoch so, dass sie Dateien verändern, die von Proxmox-Paketen installiert wurden. Ein künftiges Update kann diese Dateien ersetzen, die Anpassungen löschen oder Annahmen zunichtemachen, die das Theme über die alte UI-Struktur getroffen hat.

Moderne Community-Projekte handhaben diesen Lebenszyklus deutlich besser als frühere Lösungen, doch die Einstellung "Das ist ja nur CSS" ist trotzdem kein belastbarer Betriebsplan.

Kann man Proxmox VE wirklich anpassen?

Ja, aber unter "Theme" kann man zwei völlig unterschiedliche Dinge verstehen. Proxmox VE besitzt bereits einen offiziellen Selektor für Farbdesigns. Die Weboberfläche kann den Browsereinstellungen folgen oder die offiziell unterstützten Hell- und Dunkel-Stile von Proxmox nutzen. Das ist der sichere Weg, da diese Stile direkt mit dem Produkt ausgeliefert werden.

Community-Themes gehen viel weiter. Sie können die Farbpalette austauschen, Kacheln und Navigation neu gestalten, Diagrammfarben und Typografie ändern, eigenes Branding einfügen und die Oberfläche wie ein komplett anderes Produkt wirken lassen.

Ein aktuelles Cyberpunk-Experiment hat gezeigt, warum das so viele Administratoren überrascht. Es veränderte die vertraute Proxmox-Oberfläche derart drastisch, dass die häufigste Reaktion lautete: "Ich wusste gar nicht, dass Proxmox das kann."

Der Ersteller erklärte, das Styling sei mit KI in etwa einer Stunde entstanden, nachdem das Design zuvor an einer Cockpit-Installation erprobt worden war. Das Anpassen der Grundfarben war einfach. Das Banner und andere Elemente der bestehenden Oberfläche zur korrekten Darstellung zu bewegen, war der schwierige Teil, und das beschreibt die Aufgabe ziemlich treffend. Wenn Sie ein gewachsenes Admin-Interface anpassen, bearbeiten Sie fremdes HTML, ExtJS-Komponenten, CSS-Hierarchien, Diagramme, Abstände, Icons und Update-Zyklen. Das erfordert weit mehr, als bloß Neon-Lila auszuwählen.

Für den weiteren Plattformkontext behandelt die Mr.PlanB Proxmox-Übersicht jene Aspekte von Proxmox, die viel wichtiger sind als das Aussehen, sobald das Homelab zu echter Infrastruktur wird.

Unterstützt Proxmox eigene Themes offiziell?

Nein. Proxmox-Entwickler haben deutlich klargestellt, dass die offizielle Theme-Unterstützung auf die integrierten Optionen beschränkt ist.

In einer Support-Diskussion aus dem Jahr 2025 antwortete ein Proxmox-Mitarbeiter auf eine Frage zu Drittanbieter-Themes, dass es über den Dark Mode hinaus keine Unterstützung gebe. Ein weiterer erfahrener Nutzer erklärte die Ursache: Projekte wie PVEDiscordDark arbeiten so, dass sie Theme-Dateien installieren und originale PVE-Webdateien patchen.

Das Theme hängt also davon ab, dass die interne Struktur der Weboberfläche kompatibel bleibt. Wenn Proxmox einen Klassennamen ändert, ein Template verschiebt, eine JavaScript-Komponente anpasst oder das Widget-Toolkit aktualisiert, kann das Theme optisch oder funktional kaputtgehen.

Das macht Community-Themes nicht schlecht, aber man muss sie als individuelle Eingriffe verstehen. Viele Open-Source-Systeme funktionieren nach demselben Prinzip: Quellcode und Assets sind frei zugänglich, Sie können praktisch alles ändern, aber nicht jede Anpassung ist eine offiziell unterstützte Erweiterungsschnittstelle.

Warum verschwinden eigene Themes nach Updates manchmal?

Paket-Upgrades können Dateien überschreiben, die das Theme modifiziert hat. Frühere Proxmox-Theme-Projekte zwangen Nutzer oft dazu, nach jedem Update von pve-manager oder zugehörigen UI-Paketen einen Installer erneut auszuführen. PVEDiscordDark dokumentiert beispielsweise, dass der Installationsbefehl nach einem Proxmox-Update wiederholt werden muss, weil die betreffenden Dateien ersetzt werden.

Dieselbe Sorge tauchte auch beim Cyberpunk-Theme sofort auf. Ein langjähriger Anwender erinnerte sich daran, Jahre zuvor mit Themes experimentiert zu haben, und meinte, er habe damit aufgehört, weil jedes Upgrade die Änderungen wieder zunichtemachen konnte.

Wenn ein Theme eine Datei unter /usr/share/pve-manager/ oder /usr/share/javascript/proxmox-widget-toolkit/ editiert, gehören diese Pfade installierten Paketen. Wenn APT ein neueres Paket installiert, stellt es die Originalversionen dieser Dateien wieder her. Ihr Theme ist dann weg, teilweise beschädigt oder trifft auf ein Layout, für das es nie getestet wurde. Ein Theme, das heute perfekt aussieht, braucht eine verlässliche Update-Strategie.

Wie macht ProxMorph Themes updatefest?

ProxMorph integriert die Update-Beständigkeit direkt in das Theme-System, sodass Sie nicht manuell daran denken müssen. Das Projekt unterstützt derzeit Proxmox VE 8.x und 9.x, Proxmox Backup Server 3.x und 4.x sowie Proxmox Datacenter Manager 1.x. Es bietet 23 Themes in mehreren Kollektionen, darunter Catppuccin, Dracula, Nord, Gruvbox, Solarized, Tokyo Night, UniFi, GitHub Dark und Blue Slate.

Der Installationsprozess ist dabei wichtiger als die reine Theme-Auswahl. ProxMorph kopiert CSS-Dateien in das Proxmox-Widget-Toolkit, patcht die Theme-Zuordnung, damit die neuen Varianten im nativen Color-Theme-Menü erscheinen, schleust das nötige JavaScript oder CSS für Diagramme und produktspezifische UI-Elemente ein und installiert einen APT-Hook. Dieser Hook wendet die lokalen Patches nach relevanten Proxmox-Updates automatisch erneut an. Ein Upgrade kann modifizierte Dateien zwar weiterhin ersetzen, das Theme-System versucht danach jedoch, die frischen Kopien selbstständig wieder anzupassen. Das ist weit praxistauglicher, als vom Administrator zu verlangen, nach jedem Update an einen Shell-Befehl zu denken.

ProxMorph sichert vor Änderungen zudem die Originaldateien und liefert einen Deinstallationsbefehl mit, um sie wiederherzustellen. Diese beiden Funktionen wiegen schwerer als die optische Politur. Eine Modifikation lässt sich viel leichter rechtfertigen, wenn man vorher genau weiß, wie sie Updates übersteht und wie man sie wieder loswird.

Ist ProxMorph ein offizieller Teil von Proxmox?

Nein. Es bindet sich zwar in den nativen Theme-Selektor von Proxmox ein, bleibt aber ein Drittanbieter-Community-Projekt. Nach der Installation erscheint ein ProxMorph-Theme im normalen Color-Theme-Dropdown und fühlt sich für den Benutzer nativ an. Unter der Haube patcht der Installer jedoch weiterhin Systemdateien.

Die Projektdokumentation geht damit erfreulich transparent um. Sie listet exakt auf, was geändert wird, wohin CSS kopiert wird, wie die Theme-Map angepasst wird, welche Index-Templates angefasst werden, wo der Update-Hook liegt und wo Backups abgelegt werden. Genau das erwartet man von einem solchen Werkzeug.

Der Installer läuft mit Root-Rechten. Lassen Sie sich daher durch die Floskel "Das ist doch nur ein Theme" nicht davon abbringen, das Skript vorab zu lesen. ProxMorph veröffentlicht inzwischen SHA256-Manifeste und Build-Nachweise für Releases, und die Dokumentation empfiehlt ausdrücklich, install.sh vor der Ausführung zu prüfen. Das ist ein guter Rat für jedes Community-Skript, das Sie auf einem Hypervisor ausführen.

Sind eigene Themes auf Produktivservern eine schlechte Idee?

Nicht zwangsläufig. Wie viel Risiko vertretbar ist, hängt von der Implementierung ab. Die konservativste Haltung lautet: Das Management-Interface ist ein Arbeitswerkzeug, optische Anpassungen bringen kaum betrieblichen Mehrwert, schaffen aber eine zusätzliche Fehlerquelle. Viele Administratoren reagieren genau so: Dient der Cluster als Produktivinfrastruktur, fasst man die Oberfläche lieber nicht an.

Die Gegenseite hat ebenfalls gute Argumente. Ein CSS-Theme ist meilenweit davon entfernt, Ceph, Corosync, Kernelmodule oder VM-Storage zu manipulieren. Manche Unternehmen nutzen eigenes Branding, Boot-Logos, Farbsysteme oder visuelle Trennungen zwischen Umgebungen ohne jedes Problem.

Visuelle Unterschiede können im Betrieb sogar helfen. Wenn die Produktion dunkelrot, das Staging blau und ein Lab-Cluster cyberpunk-lila hinterlegt ist, verwechselt man Umgebungen seltener. Das funktioniert aber nur, wenn die Anpassung absolut berechenbar bleibt.

Ich würde drei Regeln anwenden:

1. Das Theme muss restlos entfernbar sein.
2. Die Originaldateien müssen wiederherstellbar sein.
3. Ein Proxmox-Update darf niemals davon abhängen, ob das Theme kompatibel bleibt.

Sollte die Weboberfläche nach einem Update unbrauchbar werden, müssen Sie in der Lage sein, den Host problemlos über SSH zu verwalten und die Modifikation rückgängig zu machen.

Ein Proxmox Health Check bewertet zwar nicht Ihre Farbpalette, erinnert aber daran, die betrieblichen Grundlagen des Clusters abzusichern, bevor man Zeit in das optische Erscheinungsbild investiert.

Ist browserseitiges Theming sicherer?

Ja, wenn Sie lediglich eine andere Optik wünschen. Ein Vorschlag aus der Proxmox-Community lautet, eigenes CSS über eine Browser-Erweiterung wie Stylus einzubinden und die Serverdateien komplett in Ruhe zu lassen. Die Anpassung verbleibt dann vollständig auf dem Client und Proxmox bleibt unberührt. Wenn das Theme Probleme macht, deaktiviert man das Stylesheet. Wenn ein Administrator Cyberpunk-Neon bevorzugt und ein anderer das Standard-Design will, kommen beide auf ihre Kosten.

Ein browserseitiges Theme kann zwar ebenfalls brechen, wenn Proxmox sein DOM oder CSS aktualisiert, die Auswirkung bleibt jedoch auf den Browser beschränkt und berührt niemals den Administrationsserver. Das macht diesen Ansatz besonders für Produktivsysteme attraktiv.

Der Nachteil besteht darin, dass das Theme an den Browser gebunden ist und nicht am Cluster hängt. Zudem erfordern dynamische Elemente wie Diagramme mitunter mehr als reines CSS. Serverseitige Projekte liefern ein vollständigeres und einheitlicheres Ergebnis. Sie tauschen hier Komfort und Vollständigkeit gegen saubere Isolation.

Wie experimentiert man am sichersten mit Themes?

Behandeln Sie das Theme wie jede andere nicht-essenzielle Anpassung und stellen Sie sicher, dass es leicht rückgängig gemacht werden kann. Ein bewährtes Vorgehen sieht so aus:

1. Vergewissern Sie sich, dass der SSH-Zugriff funktioniert, bevor Sie die Web-UI anfassen.
2. Sichern Sie alle Dateien, die das Theme modifizieren wird.
3. Lesen Sie den Installer durch, anstatt ein unbekanntes Skript blind in eine Root-Shell zu leiten.
4. Bevorzugen Sie ein getaggtes Release oder einen festen Commit gegenüber einem dynamischen Branch.
5. Testen Sie das Ganze zuerst auf einem unkritischen Node oder in einer Testumgebung.
6. Wenden Sie das Theme an.
7. Testen Sie Login, Konsolenzugriff, Storage-Ansichten, Backup-Übersichten, Diagramme, Tasks und mobile Layouts.
8. Führen Sie ein reguläres Proxmox-Update durch.
9. Überprüfen Sie, ob die Benutzeroberfläche nach dem Update weiterhin funktioniert.
10. Testen Sie die Deinstallation oder den Rollback, bevor Sie die Schritte vergessen haben.

Viele Anwender überspringen gerne den Update-Test. Man weiß jedoch erst dann sicher, ob ein Theme taugt, wenn man gesehen hat, was passiert, nachdem die modifizierten Pakete ersetzt wurden.

Proxmox anpassen ist leicht, die Wartung macht die Arbeit

Das Cyberpunk-Experiment beweist, wie wenig Zeit modernes CSS und KI-Unterstützung heute benötigen, um ein optisch beeindruckendes Ergebnis zu erzielen. Das senkt die Hürde für Experimente, entbindet einen aber nicht von der anschließenden Wartung.

Die offiziellen Hell- und Dunkel-Themes von Proxmox werden gepflegt. Alles darüber hinaus sollte als zusätzliche Anpassungsebene verstanden werden, die mit Änderungen der Weboberfläche Schritt halten muss.

Wenn Sie nur andere Farben möchten, ist clientseitiges CSS die risikoärmste Option. Wünschen Sie ein durchdachtes, systemweites Design, ist ein Projekt wie ProxMorph attraktiv, weil es sich in den nativen Selektor einfügt, Änderungen dokumentiert, Backups anlegt und Patches nach Updates automatisch neu ausführt.

Und wenn Sie Ihr eigenes Cyberpunk-Interface bauen möchten: Nur zu. Stellen Sie einfach sicher, dass die Rollback-Prozedur deutlich unspektakulärer verläuft als das Design selbst.