GPTWOL kann unter ZimaOS als benutzerdefinierte Docker-Anwendung ausgeführt werden. Wichtig an der Community-YAML-Datei sind jedoch nicht die alten Beispiel-Anmeldedaten. Die Anwendung benötigt ein Host-Netzwerk, damit sie Wake-on-LAN-Pakete im lokalen Netzwerk senden kann, persistenten Speicher für ihre Datenbank und Cron-Daten sowie einen Webport, der nicht bereits von einem anderen Dienst verwendet wird.
Der Thread vom Januar 2026 ist als funktionierender Konfigurationsstand nützlich, aber sowohl GPTWOL als auch ZimaOS wurden weiterentwickelt. Die aktuelle GPTWOL-Dokumentation erfordert für Wake-on-LAN weiterhin ein Host-Netzwerk, während aktuelle ZimaOS-Versionen einen leistungsfähigeren YAML-Workflow bieten. Betrachten Sie die Quelldatei als Ausgangspunkt und prüfen Sie die aktuellen Optionen des Upstream-Projekts, bevor Sie sie importieren.
Was die Community-YAML-Datei konfiguriert hat
Die freigegebene Anwendungsdefinition verwendete das Image misterbabou/gptwol:latest, network_mode: host und restart: unless-stopped. Außerdem wurden GPTWOL-Daten dauerhaft in zwei Host-Ordnern gespeichert, die in /app/db und /etc/cron.d eingebunden wurden.
Die Quellkonfiguration stellte die GPTWOL-Oberfläche über Port 99 bereit und legte eine Zeitzone für geplante Aufweckvorgänge fest. Diese Werte sind nicht universell gültig. Wählen Sie einen freien Hostport und verwenden Sie die Zeitzone, die dem Rechner entspricht, auf dem der Container ausgeführt wird.
Warum GPTWOL ein Host-Netzwerk verwendet
Die aktuelle Upstream-Dokumentation von GPTWOL besagt, dass der Container den Host-Netzwerkmodus benötigt, um Wake-on-LAN-Befehle im LAN zu senden. Das unterscheidet sich von einer gewöhnlichen Webanwendung, die häufig isoliert über ein Docker-Bridge-Netzwerk und einen einzelnen veröffentlichten Port betrieben werden kann.
Das Host-Netzwerk verändert außerdem den Umgang mit Ports. Die Anwendung lauscht direkt im Host-Netzwerk von ZimaOS, daher muss der ausgewählte GPTWOL-Port bereits frei sein. Wenn sich die Webseite nicht öffnet, überprüfen Sie den konfigurierten Port und prüfen Sie, ob dort bereits ein anderer Dienst lauscht, bevor Sie andere Router-Einstellungen ändern.
Aktuelle Docker-Konfiguration von GPTWOL dokumentiert den erforderlichen Netzwerkmodus, Speicherpfade, Authentifizierungsoptionen und Zeitplanfunktionen.
Beispiel-Anmeldedaten nicht wiederverwenden
Die Community-YAML-Datei aktivierte die lokale Authentifizierung und verwendete einfache Beispiel-Anmeldedaten. Sie zeigen, wie der ursprüngliche Nutzer die Anwendung konfiguriert hat, sind jedoch keine sicheren Standardwerte, die Sie bei einer neuen Installation übernehmen sollten.
Wenn Sie die lokale Authentifizierung aktivieren, ersetzen Sie alle öffentlichen Beispiel-Benutzernamen und -Passwörter vor der ersten produktiven Bereitstellung. GPTWOL unterstützt in aktuellen Versionen auch OIDC. In beiden Fällen warnt das Upstream-Projekt davor, den Dienst ohne geeignete Authentifizierung direkt dem öffentlichen Internet auszusetzen.
Wake-on-LAN ist normalerweise eine Funktion zur Steuerung im LAN. Wenn Sie Geräte von unterwegs aufwecken müssen, verwenden Sie vorzugsweise eine sichere Fernzugriffsebene, statt die GPTWOL-Weboberfläche direkt über einen öffentlichen Port bereitzustellen.
YAML in aktuellem ZimaOS importieren oder bearbeiten
Der Thread vom Januar 2026 stammt aus der Zeit vor dem aktuellen YAML-Erlebnis von App Store 2.0. ZimaOS 1.7 führte die native YAML-Bearbeitung für Anwendungen ein, und ZimaOS 1.7.1 verbesserte außerdem die Kompatibilität beim Speichern von YAML-Dateien. Daher stimmen Screenshots oder Schaltflächenpositionen aus dem ursprünglichen Beitrag möglicherweise nicht mehr mit der aktuellen Oberfläche überein.
Halten Sie die Compose-Dienstdefinition einfach: Image, Host-Netzwerk, Neustart-Richtlinie, erforderliche Umgebungsvariablen und persistente Volumes. Übernehmen Sie veraltete x-casaos-Metadaten nicht automatisch, nur weil sie in einer exportierten Datei enthalten waren, es sei denn, der aktuelle ZimaOS-App-Workflow benötigt sie tatsächlich.
Versionshinweise zu ZimaOS 1.7.1 beschreiben die aktuellen Verbesserungen der YAML-Kompatibilität.
GPTWOL kann WOL auf einem nicht kompatiblen Ziel nicht aktivieren
GPTWOL sendet das Aufweckpaket. Es macht einen nicht kompatiblen Computer jedoch nicht Wake-on-LAN-fähig. Auf dem Zielrechner muss Wake-on-LAN weiterhin in der Firmware und im Betriebssystem aktiviert sein, und der Netzwerkadapter muss das Magic Packet im vorgesehenen Energiestatus empfangen können.
Bevor Sie den Container untersuchen, stellen Sie sicher, dass das Zielgerät mit einem anderen bekannten, funktionierenden WOL-Tool im selben LAN aufgeweckt werden kann. Wenn das funktioniert, testen Sie anschließend GPTWOL. Wenn kein Tool das Zielgerät aufwecken kann, untersuchen Sie zuerst BIOS, Netzwerkkarte, Herunterfahrzustand und Netzwerkpfad des Zielgeräts.
