Proxmox VE Helper-Scripts der Community: hunderte Dienste mit einem Befehl in die Proxmox-Shell

Ein Befehl, ein Container: der Ansatz von Proxmox VE Helper-Scripts

community-scripts/ProxmoxVE ist die Community-Edition der Proxmox VE Helper-Scripts, einer Sammlung von Shell-Automatisierung, die selbst gehostete Dienste mit einem einzigen Befehl auf Proxmox VE installiert. Das Prinzip laut README: Befehl in die Proxmox-Shell einfügen, ein paar Fragen beantworten, und der Container oder die VM läuft. Das Projekt versteht sich als Fortsetzung der ursprünglichen Arbeit von tteck und wird von der Community weiterentwickelt.

Die Sammlung deckt laut README hunderte Dienste ab, von Hausautomatisierung über Medienserver und Netzwerkwerkzeuge bis zu Datenbanken und Monitoring-Stacks. Die Ziffern belegen den Zuspruch: 29419 Sterne, 2855 Forks und nur 17 offene Issues zum Erfassungszeitpunkt. Die Release-Historie ist als Tages-Snapshots organisiert, zuletzt 2026-08-28, 2026-08-27 und 2026-08-26, also ein täglicher Veröffentlichungsrhythmus. Die Skriptsprache ist Shell, die Lizenz ist MIT, und die Projektseite community-scripts.org dient als Katalog mit Suchfunktion.

Anforderungen: Proxmox VE 8.4 bis 9.2 mit Root-Shell und Netz

Das README nennt vier Voraussetzungen in tabellarischer Form. Proxmox VE muss in der Version 8.4, 9.0, 9.1 oder 9.2 vorliegen, das Host-Betriebssystem ist Proxmox VE selbst, also Debian-basiert. Gefordert wird Root-Shell-Zugriff auf dem Proxmox-Host, und während der Installation ist eine Internetverbindung nötig.

Damit ist der Einsatzbereich abgesteckt: Die Skripte laufen auf dem Host, nicht in einem bestehenden Container, und sie brauchen das Netz, weil sie Pakete und Abbilder herunterladen. Ältere Proxmox-VE-Versionen werden im README nicht aufgeführt, und ob sie funktionieren, bleibt unausgeführt. Ebenso wenig gibt es einen dokumentierten Offline- oder Luftspalt-Workflow; wer einen abgeschotteten Betrieb plant, muss die Skripte selbst auf ihre Netzaufrufe prüfen. Der Umstand, dass Root-Shell-Zugriff vorausgesetzt wird, gehört zu jeder Risikoabwägung, denn die Befehle stammen aus einem Community-Repository und werden mit Hostrechten ausgeführt.

Ablauf von community-scripts.org bis zur laufenden Instanz

Der dokumentierte Weg verläuft in fünf Schritten: Auf community-scripts.org nach dem gewünschten Dienst suchen, etwa Home Assistant, Nginx Proxy Manager oder Jellyfin, den einzeiligen Installationsbefehl von der Skriptseite kopieren, die Proxmox-Shell öffnen, den Befehl einfügen und zwischen Default- oder Advanced-Einrichtung wählen, dann den Aufforderungen folgen. Jede Skriptseite dokumentiert laut README, was der Container enthält, welche Ressourcen standardmäßig zugewiesen werden und welche Hinweise nach der Installation gelten.

Diese Trennung von Katalog und Ausführung ist der eigentliche Entwurf des Projekts: Das Repository liefert den Code, die Website macht ihn auffindbar und dokumentiert die Parameter. Die Aufforderungen im Skript sammeln die wenigen Eingaben, die der Modus benötigt, und der Rest läuft unbeaufsichtigt durch. Für die Auswahl des richtigen Modus genügt die Faustregel aus dem README: Wer schnell ein Standardsetup will, nimmt Default; wer Containergröße, Netzwerk oder Speicher-Backend selbst bestimmen will, nimmt Advanced.

Default- und Advanced-Modus plus Post-Install-Helfer

Jedes Skript folgt laut README demselben Muster. Der Default-Modus wählt vernünftige Ressourcenwerte für CPU, RAM und Speicher und stellt nur die minimal nötigen Fragen; die meisten Installationen seien in unter fünf Minuten abgeschlossen. Der Advanced-Modus gibt vor der Installation die volle Kontrolle über Containereinstellungen, Netzwerk, Speicher-Backends und Konfiguration auf Anwendungsebene.

Nach der Installation bringt jeder Container einen Post-Install-Helfer mit, der aus der Proxmox-Shell erreichbar ist. Er übernimmt laut README drei Aufgabenklassen: Updates für den installierten Dienst einspielen, Anwendungseinstellungen ändern, ohne Konfigurationsdateien manuell zu editieren, und grundlegende Fehlersuche samt Logzugriff. Der Helfer ist damit der Grund, warum die Installationsbequemlichkeit nicht mit dem ersten Start endet; Wartungsaufgaben, die sonst je Dienst eigene Verfahren erfordern, laufen über dieselbe Schnittstelle.

Kategorien von Home Assistant und Immich bis Vaultwarden und n8n

Das README organisiert die Sammlung nach Kategorien mit Beispieldiensten. Unter Hausautomatisierung stehen Home Assistant, Zigbee2MQTT, ESPHome und Node-RED. Im Medienbereich werden Jellyfin, Plex, Radarr, Sonarr und Immich genannt. Die Netzwerkkategorie listet AdGuard Home, Nginx Proxy Manager, Pi-hole und Traefik, das Monitoring umfasst Grafana, Prometheus, Uptime Kuma und Netdata.

Für Datenbanken werden PostgreSQL, MariaDB, Redis und InfluxDB aufgeführt, unter Sicherheit stehen Vaultwarden, CrowdSec und Authentik, und die Rubrik Entwicklung und Werkzeuge nennt Gitea, Portainer, VS Code Server und n8n. Die vollständige Liste verweist das README auf community-scripts.org/categories mit dem Hinweis, dass regelmäßig neue Skripte hinzugekommen sind. Diese Breite erklärt die Reichweite des Projekts: Es deckt den gängigen Bestand des Self-Hosting-Betriebs ab, statt sich auf eine einzelne Softwaregruppe zu beschränken.

Beitragweg: neue Skripte über ProxmoxVED, Fixes in diesem Repo

Die Beitragsregeln sind eng gefasst. Neue Skripte gehören laut README ausdrücklich nicht in dieses Repository, sondern in das separate ProxmoxVED, wo sie zuerst getestet werden. Pull-Requests, die direkt neue Skripte gegen ProxmoxVE öffnen, werden geschlossen. Bugfixes und Verbesserungen an bestehenden Skripten dagegen gehören in dieses Repo, nach Lektüre der Contributing Guidelines.

Zwei weitere Regeln stehen im README: Pull-Requests sollen fokussiert bleiben, eine Korrektur oder ein Feature pro PR, und jedes Skript muss dokumentieren, was es installiert, samt nicht offensichtlicher Entscheidungen in der zugehörigen JSON-Metadatendatei. Die übrigen Kanäle sind nach Zweck sortiert: Bugs an Issues, Wünsche an Discussions, Sicherheitslücken an die Security Policy, Hilfe im Discord. Das Kernteam umfasst sieben Namen: MickLesk, michelroegl-brunner, BramSuurdje, CrazyWolf13, tremor021, vhsdream und asylumexp.

Fazit: Komfort mit Hostrechten, Spenden weiter an Krebsforschung

Das Projekt finanziert sich über Spenden, angenommen über Ko-fi und community-scripts.org/donate. Das README erklärt, dass Freiwillige alle Infrastrukturkosten selbst tragen und in ihrer Freizeit arbeiten, und dass 30 Prozent aller erhaltenen Spenden direkt an Krebsforschung und Hospizpflege weitergeleitet werden, ein Anliegen, das tteck wichtig war. Die MIT-Lizenz erlaubt freie Nutzung, Änderung und Weitergabe; der Lizenztext schließt jede Gewährleistung aus.

Für die Bewertung bleibt ein Punkt strukturell: Ein-Kommando-Installation mit Root-Rechten verlagern Vertrauensentscheidungen auf die Community-Prüfung. Das Projekt adressiert das mit dem Zwei-Repository-Modell, der JSON-Metadatendokumentation je Skript und der täglichen Release-Prüfung, aber der Nutzer führt den Befehl dennoch auf dem Host aus. Wer das akzeptiert, bekommt mit dieser Sammlung einen der schnellsten Wege, einen Proxmox-Host mit praktischen Diensten zu bestücken; wer strenge Change-Kontrollen braucht, wird eher einzelne Skripte geprüft übernehmen als den Katalog blind laufen lassen.

Redaktionelles Fazit

Proxmox VE Helper-Scripts passen für Proxmox-Administratoren, die auf Hostern mit Version 8.4 bis 9.2, Root-Zugriff und Internetanbindung gängige selbst gehostete Dienste schnell aufsetzen wollen, von Home Assistant bis Vaultwarden. Vor dem Einfügen eines Befehls lohnt ein Blick auf die jeweilige Skriptseite mit Ressourcenvorgaben und Post-Install-Hinweisen; wer neue Skripte beitragen will, muss den Umweg über das Prüfrepository ProxmoxVED einplanen, direkte PRs hierfür werden geschlossen.

Offizielle Quellen

1. Official documentation
2. Official README
3. Project repository
4. Release notes