· NetBox-Docker on Portainer

Status: User forked original netbox docker repository

1) Portainer: Repository-Stack vorbereiten

Portainer UI → Stacks → Add stack → Repository

Git repository: Unser geforktes netbox-docker Repository eintragen.
Repository reference: Branch wählen (z. B. main).
Compose path: docker-compose.yml
Additional paths +Add file: docker-compose.override.yml
Enable relative path volumes: aktivieren.
Base path: /var/docker als relative path setzen.

2) NetBox-Plugins

netbox-topology-views (≥4.2.0, <5.0.0) – Interaktive L2/L3-Topologieansicht.
netbox-lifecycle (≥1.1.0, <2.0.0) – Lifecycle-/EoX-Verwaltung für Geräte.
netbox-floorplan-plugin (≥0.8.0) – Visualisierung von Racks/Assets in 2D-Gebäudeplänen.
pynetbox (≥7.0.0) – Python-Client für die NetBox-API (benötigt für einige Plugins).
netbox-lists – Flexible Listen-/Tabellenansichten für Objekte.
netbox-inventory – Inventar- und Asset-Verwaltung in NetBox.
netbox-reorder-rack – Intuitive Drag-and-Drop Reorganisation von Racks.
netboxlabs-diode-netbox-plugin (z. B. v1.3.1 oder aktuellste Version) – Daten-Ingestion via Diode (vereinfacht Hinzufügen/Aktualisieren von Netzwerkdaten) :contentReference[oaicite:0]{index=0}

Temporär deaktiviert da Versionskonflikt (auskommentiert in requirements-plugins.txt):

netbox-proxbox (≥0.0.6b2) – Integration von Proxmox Clustern in NetBox.
proxbox-api (≥0.0.2) – API-Helper für Proxbox.

2.1 Plugin-Installation mit netbox-docker

netbox-docker unterstützt eine separate requirements-plugins.txt, die beim Image-Build installiert wird.

2.2 `requirements-plugins.txt`

netbox-topology-views>=4.2.0,<5.0.0
netbox-lifecycle>=1.1.0,<2.0.0
netbox-floorplan-plugin>=0.8.0
pynetbox>=7.0.0
netbox-initializers>=4.4.0
netbox-lists
netbox-inventory
netbox-reorder-rack
# netbox-proxbox>=0.0.6b2
# proxbox-api>=0.0.2

3) Portainer Stack deploy

3.1 Admin User erstellen

Um einen ersten Administrator-Account (Superuser) anzulegen, kann der Befehl direkt im laufenden NetBox-Container ausgeführt werden.

Command

docker exec -it netbox-docker-netbox-1 \
  /opt/netbox/venv/bin/python /opt/netbox/netbox/manage.py createsuperuser

3.2 Defaults initialisieren

Der hinterlegte default value stack für netbox_initializers plugin