🎓 Lessons Learned — NetBox naar Portainer Migratie¶

Migratie van een bestaande Docker Compose setup naar een Portainer Stack. Portainer is strikter dan de CLI bij paden en volumes.

1. Absolute vs. relatieve paden¶

Portainer voert compose bestanden uit vanuit een eigen interne directory — relatieve paden werken daarin niet.

2. Volume name mismatch¶

Een veelvoorkomende val bij het verplaatsen van Compose projecten.

• Probleem: Originele install gebruikte project naam netbox-docker → volumes heetten netbox-docker_netbox-postgres-data. Nieuwe Portainer stack maakte lege volumes aan met naam netbox_netbox-postgres-data.
• Oplossing: Expliciete name: property in het volumes: blok om logische naam te koppelen aan de historische volume naam:

volumes:
  netbox-postgres-data:
    name: netbox-docker_netbox-postgres-data

3. YAML anchor overerving conflict¶

• Probleem: netbox-worker en netbox-housekeeping erfden ports: van het netbox: &netbox anchor → "port is already allocated" fout.
• Oplossing: Expliciet overschrijven met een lege lijst:

netbox-worker:
  ports: []

4. Port conflicten¶

Reproduceerbare checklist voor Portainer migraties¶

1. Stop oude project: docker compose down
2. Noteer exacte namen van bestaande volumes: docker volume ls
3. Maak nieuwe docker-compose.yml voor Portainer:
4. Embed alle secrets/variabelen in environment: blokken
5. Gebruik absolute paden voor host-gemounte volumes
6. Voeg ports: toe aan hoofdservice, ports: [] aan worker/secondary services
7. Map volumes in volumes: blok met name: property naar historische namen
8. Deploy in Portainer, update proxy naar nieuwe port

Verwant¶

• [[🚀 Docker Host Migration Plan LXC to VM]]
• [[Docker Installatie Guide Ubuntu]]