Dokumentation: phpIPAM Installation mit Docker und Traefik

Diese Anleitung beschreibt die schrittweise Einrichtung von phpIPAM in einem Docker-Setup mit:

• separatem MariaDB-Container
• phpIPAM Webinterface (Image: phpipam/phpipam-www:latest)
• Kea DHCP (optional)
• Traefik als Reverse Proxy mit HTTPS
• persistenten Volumes für Daten und Konfiguration

• Zwei Server (Docker-Hosts):
• Server 1: Traefik + Public DNS (z. B. ipam.example.com)
• Server 2: phpIPAM, MariaDB, Kea-DHCP
• Gemeinsames internes Netzwerk z. B. über WireGuard, Tailscale oder VPN (alternativ: exposed Ports mit Caution)

snippet.plaintext

/opt/docker/ddi-stack/
├── db/                  # MariaDB-Daten
├── kea/                 # KEA-Konfiguration
├── phpipam/             # phpIPAM-Volume (persistente Daten)
├── docker-compose.yml   # Docker Stack Definition

⸻

snippet.yaml

version: '3.8'

services:

  db:
    image: mariadb:10.5
    container_name: ddi-db
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: ********
      MYSQL_DATABASE: phpipam
      MYSQL_USER: ipam
      MYSQL_PASSWORD: *****
    volumes:
      - ./db:/var/lib/mysql
    networks:
      - ddi-net

  phpipam:
    image: phpipam/phpipam-www:latest
    container_name: ddi-phpipam
    depends_on:
      - db
    environment:
      MYSQL_HOST: db
      MYSQL_USER: ipam
      MYSQL_PASS: ******
      MYSQL_DBNAME: phpipam
    volumes:
      - ./phpipam:/phpipam
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.ipam.rule=Host(`ipam.example.com`)"
      - "traefik.http.routers.ipam.entrypoints=websecure"
      - "traefik.http.routers.ipam.tls.certresolver=le"
      - "traefik.http.services.ipam.loadbalancer.server.port=80"
      - "traefik.http.routers.ipam.middlewares=mw-redirect-to-https,mw-secure-headers"
    networks:
      - ddi-net

  kea-dhcp:
    image: jonasal/kea-dhcp4:2.6.3-alpine
    container_name: ddi-kea
    network_mode: host
    volumes:
      - ./kea:/kea
    command: ["kea-dhcp4", "-c", "/kea/kea-dhcp4.conf"]
    restart: unless-stopped
    depends_on:
      - phpipam

networks:
  ddi-net:
    driver: bridge

phpIPAM

snippet.yaml

volumes:
  - ./phpipam:/phpipam

Wenn du mit einer eigenen Kopie arbeiten willst:

snippet.bash

cd /opt/docker/ddi-stack
mkdir phpipam
cd /tmp && git clone https://github.com/phpipam/phpipam.git
cp -r phpipam/* /opt/docker/ddi-stack/phpipam

Wenn du mit dem phpipam/phpipam-www arbeitest:

• Der Container nutzt: Alias „/“ „/phpipam/“
• Wichtig: Die Daten müssen in /phpipam liegen
• Prüfen mit:

snippet.bash

docker exec -it ddi-phpipam ls -lah /phpipam/index.php

Labels im Container (siehe oben)

Middlewares in traefik.yml oder Labels

snippet.yaml

middlewares:
  mw-redirect-to-https:
    redirectScheme:
      scheme: https
  mw-secure-headers:
    headers:
      frameDeny: true

Zertifikats-Resolver:

snippet.yaml

tls:
  certResolver: le

• 403 Forbidden: Volume gemountet, aber index.php fehlt oder Pfad falsch
• 404 style.css: Volume gemountet mit inkompatibler Version (z. B. Git-Master vs. Container-Version)
• config.php fehlt: cp config.dist.php config.php im Volume
• Bad Gateway: Container läuft nicht oder falscher Port (muss 80 sein)
• jQuery error: JS oder CSS wurde nicht geladen – oft wegen Pfadproblemen durch inkompatible Mounts

• Aufruf: https://ipam.example.com
• “Neue Installation” auswählen
• DB-Zugangsdaten entsprechend .env bzw. docker-compose.yml
• Admin-Zugang anlegen
• phpIPAM fertig einrichten

• /phpipam (Konfiguration, HTML, js/css)
• /var/lib/mysql (DB-Daten)
• Optional: mysqldump und tar-basierte Sicherung per Cron