GPTWOL kan köras på ZimaOS som en anpassad Docker-applikation, men den viktiga delen av communityns YAML-fil är inte de gamla exempelinloggningsuppgifterna. Applikationen behöver värdnätverk så att den kan skicka Wake-on-LAN-paket på det lokala nätverket, beständig lagring för sin databas och cron-data samt en webbport som inte redan används av någon annan tjänst.
Tråden från januari 2026 är användbar som en fungerande konfigurationsögonblicksbild, men både GPTWOL och ZimaOS har utvecklats. Den aktuella GPTWOL-dokumentationen kräver fortfarande värdnätverk för Wake-on-LAN, medan aktuella ZimaOS-versioner erbjuder ett mer avancerat YAML-arbetsflöde. Använd källfilen som utgångspunkt och kontrollera de aktuella alternativen uppströms innan du importerar den.
Vad communityns YAML konfigurerade
Den delade applikationsdefinitionen använde avbildningen misterbabou/gptwol:latest, network_mode: host och restart: unless-stopped. Den sparade också GPTWOL:s tillstånd i två värdmappar som mappades till /app/db och /etc/cron.d.
Källkonfigurationen exponerade GPTWOL-gränssnittet på port 99 och angav en tidszon för schemalagda väckningsjobb. Dessa värden är inte universella. Välj en ledig värdport och använd den tidszon som motsvarar datorn som kör containern.
Varför GPTWOL använder värdnätverk
GPTWOL:s aktuella dokumentation uppströms anger att containern behöver värdnätverksläge för att skicka Wake-on-LAN-kommandon på det lokala nätverket. Detta skiljer sig från en vanlig webbapplikation, som ofta kan förbli isolerad bakom Dockers bryggnätverk och en enda publicerad port.
Värdnätverk förändrar också hur du bör tänka kring portar. Applikationen lyssnar direkt på ZimaOS-värdens nätverk, så den valda GPTWOL-porten måste redan vara ledig. Om webbsidan inte öppnas bör du kontrollera den konfigurerade porten och se om någon annan tjänst lyssnar där innan du ändrar orelaterade routerinställningar.
Aktuell GPTWOL-Docker-konfiguration beskriver de obligatoriska nätverkslägena, lagringssökvägarna, autentiseringsalternativen och schemaläggningsfunktionerna.
Återanvänd inte exempelinloggningsuppgifterna
Communityns YAML aktiverade lokal autentisering och använde enkla exempelinloggningsuppgifter. De visar hur den ursprungliga användaren konfigurerade appen, men är inte säkra standardvärden att kopiera till en ny installation.
Om du aktiverar lokal autentisering ska du ersätta alla offentliga exempelanvändarnamn och lösenord innan den första riktiga driftsättningen. GPTWOL stöder även OIDC i aktuella versioner. I båda fallen varnar projektet uppströms för att exponera tjänsten direkt mot det offentliga internet utan korrekt autentisering.
Wake-on-LAN är vanligtvis en funktion för styrning inom det lokala nätverket. Om du behöver utlösa den när du är hemifrån bör du föredra ett säkert fjärråtkomstlager framför att placera GPTWOL:s webbgränssnitt direkt på en offentlig port.
Importera eller redigera YAML i aktuella ZimaOS
Tråden från januari 2026 publicerades före det aktuella YAML-arbetsflödet i App Store 2.0. ZimaOS 1.7 introducerade inbyggd YAML-redigering för applikationer, och ZimaOS 1.7.1 förbättrade dessutom kompatibiliteten vid sparande av YAML. Det innebär att skärmbilder eller knappplaceringar från det ursprungliga inlägget kanske inte längre stämmer med det aktuella gränssnittet.
Håll Compose-tjänstdefinitionen enkel: avbildning, värdnätverk, omstartspolicy, obligatoriska miljövärden och beständiga volymer. Ta inte med föråldrade x-casaos-metadata bara för att de förekom i en exporterad fil, såvida det aktuella ZimaOS-arbetsflödet för appar faktiskt inte behöver dem.
Versionsanteckningar för ZimaOS 1.7.1 beskriver de aktuella kompatibilitetsförbättringarna för YAML.
GPTWOL kan inte aktivera WOL på ett mål som inte stöder det
GPTWOL skickar väckningspaketet; det gör inte en inkompatibel dator kapabel att vakna. Måldatorn måste fortfarande ha Wake-on-LAN aktiverat i sin fasta programvara och sitt operativsystem, och nätverkskortet måste kunna ta emot det magiska paketet i det avsedda strömläget.
Innan du felsöker containern bör du bevisa att måldatorn kan väckas med ett annat välfungerande WOL-verktyg på samma lokala nätverk. Om det fungerar kan du därefter testa GPTWOL. Om inget verktyg kan väcka måldatorn bör du först felsöka måldatorns BIOS, nätverkskort, avstängningsläge och nätverksväg.
