Menu
Article Docker

Portainer mit Docker installieren

The VMadm

• 2 min read
Portainer mit Docker installieren

Portainer ist eine der beliebtesten Web-Oberflächen zur Verwaltung von Docker-Containern, Volumes, Networks und Stacks. Mit einer klaren, intuitiven UI macht es die Arbeit mit Docker auch für Einsteiger extrem einfach – und das komplett open-source (CE-Version).

In diesem Artikel zeige ich dir Schritt für Schritt, wie du Portainer inklusive Agent in einem Multi-Host-Setup installierst. Die Konfiguration ist für Produktion optimiert, mit persistenten Daten, automatischer Neustart und Zugriff auf den Host.

Voraussetzungen

  • Ein Server mit Docker und Docker Compose installiert
  • Root-Zugriff oder sudo-Rechte
  • Offene Ports: 9443 (HTTPS für Portainer), optional 9001 (Agent)

Die docker-compose.yml

Erstelle eine Datei namens docker-compose.yml mit folgendem Inhalt:

YAML

services:
  portainer:
    container_name: portainer
    image: portainer/portainer-ce:lts
    restart: always
    ports:
      - 9443:9443
      - 8000:8000 # Optional für Edge Agents
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./portainer_data:/data
    networks:
      - portainer_network
    depends_on:
      - agent

  agent:
    container_name: portainer_agent
    image: portainer/agent:latest
    restart: always
    ports:
      - 9001:9001
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /var/lib/docker/volumes:/var/lib/docker/volumes
      - /:/host
    networks:
      - portainer_network

volumes:
  portainer_data:

networks:
  portainer_network:
    name: portainer_network

Erklärung der wichtigsten Teile

  • portainer/portainer-ce:lts – Die stabile Community Edition (kostenlos)
  • /var/run/docker.sock – Gibt Portainer vollen Zugriff auf deinen Docker-Daemon
  • ./portainer_data:/data – Persistente Speicherung von Konfiguration und Datenbanken
  • agent – Ermöglicht die Verwaltung mehrerer Hosts und zeigt Host-Statistiken an
  • /:/host – Der Agent kann auf das Host-Dateisystem zugreifen (z. B. für Logs und System-Infos)
  • Port 9443 – Standard-HTTPS-Zugriff auf die Web-UI

Installation starten

  1. Erstelle die docker-compose.yml (kopiere den Inhalt oben hinein)

Starte die Container:Bash

docker compose up -d

Lege das Verzeichnis an und wechsle hinein:Bash

mkdir portainer && cd portainer

Die Container werden jetzt heruntergeladen und gestartet.

Erster Zugriff

Öffne deinen Browser und gehe zu:

https://192.168.202.5:9443/

Beim ersten Start wirst du aufgefordert:

  • Ein Admin-Passwort zu setzen
  • Die lokale Docker-Umgebung auszuwählen

Danach bist du im Dashboard und kannst sofort mit der Verwaltung beginnen.

Tipps für den Produktivbetrieb

  • HTTPS-Zertifikat: Portainer bringt ein selbstsigniertes Zertifikat mit. Für Produktion empfiehlt sich ein Reverse Proxy (z. B. Traefik oder Nginx) mit Let's Encrypt.
  • Backup: Das Volume portainer_data enthält alle Einstellungen – regelmäßig sichern!
  • Updates: Einfach docker compose pull && docker compose up -d ausführen.
Share