n8n in Docker draaien: beheer, opslag en toegang voorbereiden

Voor een lokale n8n-installatie heb je een draaiende Docker-installatie met Docker Compose nodig, plus blijvende opslag. Het onderstaande voorbeeld opent alleen de editor op je eigen computer. Het is geen complete productieopstelling en installeert geen extra AI-assistent of externe modelkoppeling.

Controleer Docker en maak een projectmap

Voer in een terminal de twee controles uit. Beide moeten een versienummer teruggeven. Verschijnt een melding dat de Docker-daemon niet bereikbaar is, start dan eerst Docker; dat los je niet op door de n8n-configuratie te veranderen.

docker --version
docker compose version
mkdir n8n-lokaal
cd n8n-lokaal

Werk voor deze proef in een nieuwe map. Wie al een n8n-installatie heeft, moet eerst bepalen waar de bestaande database en encryptiesleutel staan. Een tweede leeg volume kan anders de indruk geven dat alle workflows verdwenen zijn.

Een lokale Compose-configuratie

Sla dit op als compose.yaml. Het voorbeeld is afgeleid van n8n's officiële Compose-route en beperkt de bereikbaarheid tot de lokale computer. Versie 2.41.4 wordt op de geraadpleegde documentatie als stable genoemd. Controleer bij later gebruik de actuele stabiele versie en release-instructies voordat je het versienummer wijzigt. Dit voorbeeld is op documentatie gecontroleerd, niet op jouw machine uitgevoerd.

services:
  n8n:
    image: n8nio/n8n:2.41.4
    restart: unless-stopped
    ports:
      - "127.0.0.1:5678:5678"
    environment:
      - GENERIC_TIMEZONE=Europe/Amsterdam
      - TZ=Europe/Amsterdam
      - N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
    volumes:
      - n8n_data:/home/node/.n8n
volumes:
  n8n_data:

Het volume bewaart onder meer de standaard SQLite-database en encryptiesleutel buiten de vervangbare container. De poortbinding voorkomt dat je met dit voorbeeld bewust alle netwerkinterfaces openzet. Ze is geen uitnodiging om deze editor via een router openbaar te maken.

Starten en de eerste opslag controleren

docker compose up -d
docker compose ps
docker compose logs --tail=80 n8n

Open http://localhost:5678 op dezelfde computer en doorloop het aanmaken van het eigenaaraccount. Maak daarna een kleine workflow zonder externe accounts of schrijfhandelingen. Sla hem op, herstart de container met docker compose restart n8n en controleer of de workflow terugkomt. Zo controleer je jouw opslag voordat je echte processen toevoegt.

Bereik je de editor niet, kijk eerst in docker compose ps of de container draait en in de logs naar de fout. Bij een bezette poort kun je bijvoorbeeld alleen de eerste 5678 in de poortbinding vervangen door 5679. Je opent dan lokaal poort 5679; de interne containerpoort blijft 5678.

Stoppen, back-uppen en bijwerken

Met docker compose stop stop je de container zonder het volume te verwijderen. Gebruik niet achteloos docker compose down -v: daarmee vraag je Docker ook volumes te verwijderen. Een volume beschermt tegen containervervanging, maar is op zichzelf geen back-up tegen een defecte schijf of een fout in de gegevens.

Leg bij een back-up vast welke versie en configuratie erbij horen. Bewaar de database én de bijbehorende encryptiesleutel; anders kun je opgeslagen credentials mogelijk niet herstellen. Stop schrijvende processen wanneer je een consistente kopie van SQLite maakt en oefen herstel in een aparte omgeving. Controleer vóór een update de release-instructies en bewaar de werkende versie. Alleen een ouder image terugzetten is na een databasemigratie niet altijd voldoende om terug te draaien.

Wanneer deze lokale opstelling niet genoeg is

Een externe dienst kan een webhook op jouw localhost niet bereiken. Voor blijvend gebruik op een server heb je onder meer een domein, HTTPS, toegangsbeheer en een herstelplan nodig. Volg daarvoor de officiële serverroute; verander niet alleen de poortbinding. Een workflow uit een voorbeeldbibliotheek vraagt daarnaast een eigen controle: lees n8n-templates importeren en nalopen.