← Alle gidsen

Docker op een Synology NAS: Portainer en automatische updates met Watchtower

Een NAS is meer dan een plek om bestanden te bewaren. Met Docker draai je er een mediaserver, een netwerkfilter of je eigen websites op. Portainer geeft je daar een overzichtelijke webinterface bij en Watchtower houdt je containers bij. In deze gids zet je beide op, en lees je waar je mee moet opletten.

Portainer-dashboard met draaiende containers op een Synology NAS
Mijn containeroverzicht. Alles wat ik draai, staat hier bij elkaar.

Voorbereiding

Op DSM 7.2 en nieuwer heet het pakket Container Manager, in oudere versies heette het Docker. Installeer het via het Pakketcentrum. Maak daarna in File Station een gedeelde map, bijvoorbeeld docker, met daarin een submap per toepassing. Zo staan al je instellingen op één plek en kun je ze eenvoudig meenemen in een back-up.

Portainer installeren

Maak in Container Manager onder Project een nieuw project aan met onderstaande compose-inhoud. Het pad /volume1 kan bij jou anders heten.

services:
  portainer:
    image: portainer/portainer-ce:lts
    container_name: portainer
    restart: always
    ports:
      - "9443:9443"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /volume1/docker/portainer:/data

Open daarna https://IP-VAN-JE-NAS:9443 en maak binnen enkele minuten na de start een beheerdersaccount aan. Wacht je te lang, dan sluit Portainer de installatie af uit veiligheidsoverwegingen en moet je de container herstarten.

Waarom de Docker-socket gevoelig is

Portainer en Watchtower hebben toegang tot docker.sock. Wie die toegang heeft, kan in feite alles op de host aansturen. Zet daarom Portainer nooit zonder meer open op het internet. Gebruik een sterk wachtwoord en bereik het alleen via je lokale netwerk of via een VPN.

Automatische updates met Watchtower

Watchtower controleert op een vast moment of er nieuwe versies van je images zijn, haalt ze op en herstart de container.

services:
  watchtower:
    image: containrrr/watchtower
    container_name: watchtower
    restart: always
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      WATCHTOWER_CLEANUP: "true"
      WATCHTOWER_SCHEDULE: "0 0 4 * * *"
      WATCHTOWER_LABEL_ENABLE: "true"

WATCHTOWER_SCHEDULE gebruikt een cron-notatie met zes velden, inclusief seconden: bovenstaande waarde betekent elke nacht om 04:00 uur. Met WATCHTOWER_CLEANUP worden oude images verwijderd, zodat je schijf niet volloopt. Door WATCHTOWER_LABEL_ENABLE aan te zetten, update Watchtower alleen containers die je zelf een label geeft:

labels:
  - "com.centurylinklabs.watchtower.enable=true"

Wat je beter niet blind automatisch bijwerkt

  • Databases zoals MariaDB of PostgreSQL: een grote versiesprong kan de datastructuur breken. Gebruik hier een vaste versietag.
  • Toepassingen met grote versiewissels, zoals een mediaserver of domotica-software. Lees eerst de release notes.
  • Alles zonder back-up. Maak voor je updates automatiseert een kopie van je docker-map, bijvoorbeeld met Hyper Backup.

Controleer daarnaast of het project dat je gebruikt nog actief wordt onderhouden. Wil je liever alleen een melding bij een nieuwe versie in plaats van een automatische update, dan bestaan er tools die alleen waarschuwen en niets zelf herstarten.

Eigen websites bereikbaar maken

Wil je een container onder een eigen (sub)domein bereikbaar maken, gebruik dan de ingebouwde Omgekeerde proxy van DSM (onder Aanmeldingsportaal → Geavanceerd) en een Let’s Encrypt-certificaat. Zo gaat alles over HTTPS en hoef je geen losse poorten naar buiten open te zetten.

Vragen of een fout gevonden?

Staat er iets onduidelijks of onjuists in deze gids, of heb je een aanvulling? Laat het me weten via de contactpagina. Meer uitleg over wat ik bouw lees je op Over mij, en meer gidsen vind je in het overzicht.

Watchtower-logboek met bijgewerkte containers
Watchtower aan het werk – en de reden om sommige containers juist uit te sluiten.

Wat niet werkt (en waarom)

  • Watchtower zonder uitzonderingen. Alles automatisch bijwerken klinkt fijn tot een image een breaking change introduceert. Databases en je Home Assistant-container wil je bewust updaten, met een back-up ervoor.
  • De Docker-socket read-write mounten in een container die je via het internet bereikt. Wie bij die socket komt, is effectief root op je NAS. Laat Portainer alleen binnen je eigen netwerk bereikbaar zijn.
  • :latest gebruiken voor alles. Je weet dan nooit welke versie draait en terugrollen is gokken. Pin op een major-versie, zoals :10 of :stable.
  • Containers op mappen zetten waar DSM zelf rechten beheert. Gedeelde mappen met Synology-diensten erop geven rechtenconflicten. Gebruik een eigen map met een vaste UID/GID.

Snel oplossen: symptoom, oorzaak, oplossing

SymptoomMeestal de oorzaakOplossing
Container start niet na een updateBreaking change of ontbrekende configvariabeleLogboeken bekijken, vorige tag terugzetten en pas daarna uitzoeken
"Port is already allocated"Een andere container of DSM-dienst gebruikt de poortPoort aanpassen of de oude container verwijderen
Permission denied op een gedeelde mapVerkeerde PUID/PGIDDe UID/GID van je gebruiker opzoeken en in de container zetten
Watchtower werkt nietSocket niet gemount of verkeerd pad/var/run/docker.sock:/var/run/docker.sock controleren
Alles weg na een DSM-updateContainers niet opgestart of mappen verplaatstContainers opnieuw starten en de mounts nalopen

Veelgestelde vragen

Watchtower of Diun?

Watchtower werkt bij en kan containers herstarten. Diun meldt alleen dat er een update is, jij beslist. Voor een homelab waar je niets wilt missen: Diun plus handmatig bijwerken is rustiger. Voor "zet het maar bij" is Watchtower met een expliciete uitsluitlijst de middenweg.

Hoe rol ik terug?

Zet in je compose-bestand de vorige tag in plaats van latest en start opnieuw. Daarom is taggen belangrijker dan automatisch updaten: zonder tag heb je niets om naar terug te gellen.

Moet ik Portainer eigenlijk wel gebruiken?

Als je alleen een paar containers draait: nee, docker compose via SSH is overzichtelijker en je hebt er geen extra aanvalsoppervlak bij. Portainer is handig als je veel containers hebt of dingen wilt bekijken zonder terminal.

Verder lezen

← Nginx in Docker: 403 Forbidden en een lege pagina oplossenSubdomeinen en zoekmachines: zo zorg je dat Google je kleine website vindt →