GPTWOL kan op ZimaOS worden uitgevoerd als aangepaste Docker-toepassing, maar het belangrijkste onderdeel van de community-YAML zijn niet de oude voorbeeldinloggegevens. De toepassing heeft host-netwerken nodig om Wake-on-LAN-pakketten op het lokale netwerk te kunnen verzenden, persistente opslag voor de database- en cron-gegevens, en een webpoort die nog niet door een andere service wordt gebruikt.
De thread uit januari 2026 is nuttig als werkende configuratiesnapshot, maar zowel GPTWOL als ZimaOS zijn verder ontwikkeld. De huidige GPTWOL-documentatie vereist nog steeds host-netwerken voor Wake-on-LAN, terwijl recente ZimaOS-versies een uitgebreidere YAML-workflow bieden. Beschouw het bronbestand als uitgangspunt en controleer de huidige upstream-opties voordat je het importeert.
Wat de community-YAML configureerde
De gedeelde toepassingsdefinitie gebruikte de image misterbabou/gptwol:latest, network_mode: host en restart: unless-stopped. Ook werden de GPTWOL-statusgegevens persistent opgeslagen in twee hostmappen die aan /app/db en /etc/cron.d waren gekoppeld.
De bronconfiguratie stelde de GPTWOL-interface beschikbaar op poort 99 en stelde een tijdzone in voor geplande wake-taken. Deze waarden zijn niet universeel. Kies een vrije hostpoort en gebruik de tijdzone die overeenkomt met de machine waarop de container wordt uitgevoerd.
Waarom GPTWOL host-netwerken gebruikt
Volgens de huidige upstream-documentatie van GPTWOL heeft de container de host-netwerkmodus nodig om Wake-on-LAN-opdrachten op het LAN te verzenden. Dit verschilt van een gewone webtoepassing, die vaak geïsoleerd kan blijven achter Docker-bridge-netwerken en één gepubliceerde poort.
Host-netwerken veranderen ook de manier waarop je naar poorten kijkt. De toepassing luistert rechtstreeks op het ZimaOS-hostnetwerk, dus de geselecteerde GPTWOL-poort moet vrij zijn. Als de webpagina niet opent, controleer dan de geconfigureerde poort en kijk of een andere service daar luistert voordat je andere routerinstellingen wijzigt.
Huidige GPTWOL Docker-configuratie beschrijft de vereiste netwerkmodus, opslagpaden, authenticatieopties en planningsfuncties.
Gebruik de voorbeeldinloggegevens niet opnieuw
De community-YAML schakelde lokale authenticatie in en gebruikte eenvoudige voorbeeldinloggegevens. Die laten zien hoe de brongebruiker de app configureerde, maar vormen geen veilige standaard om naar een nieuwe installatie te kopiëren.
Als je lokale authenticatie inschakelt, vervang dan vóór de eerste echte implementatie elke openbare voorbeeldgebruikersnaam en elk voorbeeldwachtwoord. GPTWOL ondersteunt in recente versies ook OIDC. In beide gevallen waarschuwt het upstreamproject ervoor om de service zonder geschikte authenticatie rechtstreeks aan het openbare internet bloot te stellen.
Wake-on-LAN is doorgaans een functie voor bediening binnen het LAN. Als je de functie buitenshuis wilt activeren, geef dan de voorkeur aan een veilige laag voor externe toegang in plaats van de GPTWOL-webinterface rechtstreeks op een openbare poort te plaatsen.
De YAML importeren of bewerken in het huidige ZimaOS
De thread uit januari 2026 dateert van vóór de huidige YAML-ervaring van App Store 2.0. ZimaOS 1.7 introduceerde native YAML-bewerking voor toepassingen en ZimaOS 1.7.1 verbeterde de compatibiliteit bij het opslaan van YAML verder. Daardoor komen schermafbeeldingen of knoplocaties uit de oorspronkelijke post mogelijk niet meer overeen met de huidige interface.
Houd de Compose-servicedefinitie eenvoudig: image, host-netwerken, herstartbeleid, vereiste omgevingswaarden en persistente volumes. Neem verouderde x-casaos-metadata niet zomaar over omdat die in een geëxporteerd bestand stond, tenzij de huidige ZimaOS-appworkflow deze daadwerkelijk nodig heeft.
Releaseopmerkingen van ZimaOS 1.7.1 beschrijven de huidige verbeteringen in YAML-compatibiliteit.
GPTWOL kan WOL niet inschakelen op een doelapparaat dat dit niet ondersteunt
GPTWOL verzendt het wake-pakket; het maakt een incompatibele computer niet geschikt om te ontwaken. Op de doelmachine moet Wake-on-LAN nog steeds zijn ingeschakeld in de firmware en het besturingssysteem, en de netwerkadapter moet het magic packet in de gewenste energiestand kunnen blijven ontvangen.
Controleer voordat je de container gaat debuggen of het doelapparaat op hetzelfde LAN kan worden gewekt met een andere bekende, goed werkende WOL-tool. Als dat lukt, test je GPTWOL. Als geen enkele tool het doelapparaat kan wekken, onderzoek dan eerst het BIOS, de netwerkadapter, de uitschakelstatus en het netwerkpad van het doelapparaat.
