Portainer Einrichtungsanleitung: Docker-Verwaltung leicht gemacht

Portainer bietet Ihnen eine Web-Oberfläche zur Verwaltung von Docker-Containern, Images, Volumes und Netzwerken. Anstatt sich docker-CLI-Befehle merken zu müssen, erhalten Sie ein übersichtliches Dashboard, das die Container-Verwaltung visuell und zugänglich macht.

Was ist Portainer?

Portainer ist eine schlanke Verwaltungsoberfläche für Docker und Kubernetes:

• Web-Dashboard — Alle Container, Images und Volumes auf einen Blick
• Stack-Verwaltung — Docker Compose Stacks direkt über die Oberfläche bereitstellen
• App-Templates — Über 100 beliebte Apps mit einem Klick bereitstellen
• Multi-Umgebung — Mehrere Docker-Hosts über eine Oberfläche verwalten
• Benutzerverwaltung — Teamzugang mit rollenbasierter Berechtigung
• Container-Konsole — Über den Browser in Container einloggen
• Logs und Statistiken — Echtzeit-Monitoring integriert

Portainer läuft als einzelner Docker-Container und benötigt minimale Ressourcen.

Portainer CE vs Business

Funktion	Community (Kostenlos)	Business ($)
Container-Verwaltung	✅	✅
Docker Compose/Stacks	✅	✅
App-Templates	✅	✅
Rollenbasierter Zugang	✅	✅
Mehrere Umgebungen	✅	✅
Kubernetes-Unterstützung	✅	✅
Registry-Verwaltung	Basis	Erweitert
GitOps-Deployments	❌	✅
Externe Authentifizierung (LDAP/OAuth)	❌	✅
Support	Community	Professionell

Für Self-Hoster und kleine Teams: CE ist mehr als ausreichend. Business richtet sich an Organisationen, die Enterprise-Authentifizierung und Audit-Trails benötigen.

VPS-Anforderungen

Portainer selbst ist ressourcenschonend, aber Sie brauchen Kapazität für Ihre Container:

• Minimum: 1 vCPU, 1GB RAM, 20GB Speicher
• Empfohlen: 2 vCPU, 4GB RAM, 40GB+ Speicher
• Betriebssystem: Ubuntu 22.04+, Debian 12+ oder jedes Linux mit Docker
• Ports: 9443 (HTTPS-Oberfläche), 8000 (Edge Agents, optional)

Empfohlene VPS-Anbieter

Anbieter	Tarif	Spezifikationen	Preis
Hostinger	KVM1	1 vCPU, 4GB RAM	$4,99/Monat
Hetzner	CX22	2 vCPU, 4GB RAM	€5,49/Monat
DigitalOcean	Basic	2 vCPU, 2GB RAM	$12/Monat
Vultr	VC2	2 vCPU, 4GB RAM	$24/Monat

Bestes Preis-Leistungs-Verhältnis: Hostinger KVM1 bietet 4GB RAM für $4,99/Monat — ausreichend für Portainer plus ein Dutzend Container.

Installationsanleitung

Schritt 1: VPS erstellen

1. Registrieren Sie sich beim Anbieter Ihrer Wahl (wir empfehlen Hostinger)
2. Erstellen Sie einen VPS mit Ubuntu 22.04 oder Debian 12
3. Wählen Sie mindestens 2GB RAM
4. Fügen Sie Ihren SSH-Schlüssel hinzu
5. Notieren Sie sich die Server-IP

Schritt 2: Docker installieren

Verbinden Sie sich per SSH mit Ihrem Server und installieren Sie Docker:

ssh root@your-server-ip

# System aktualisieren
apt update && apt upgrade -y

# Docker mit dem offiziellen Skript installieren
curl -fsSL https://get.docker.com | sh

# Installation überprüfen
docker --version
docker run hello-world

Schritt 3: Portainer CE installieren

Erstellen Sie ein Volume für Portainer-Daten und starten Sie den Container:

# Daten-Volume erstellen
docker volume create portainer_data

# Portainer starten
docker run -d \
  -p 8000:8000 \
  -p 9443:9443 \
  --name portainer \
  --restart=always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v portainer_data:/data \
  portainer/portainer-ce:sts

Das war’s. Portainer läuft.

Schritt 4: Dashboard aufrufen

Öffnen Sie Ihren Browser:

https://your-server-ip:9443

Sie sehen eine Warnung wegen eines selbstsignierten SSL-Zertifikats — das ist normal, akzeptieren Sie es.

Beim ersten Aufruf:

1. Erstellen Sie Ihr Administratorkonto
2. Legen Sie ein starkes Passwort fest (mindestens 12 Zeichen erforderlich)
3. Klicken Sie auf Get Started, um sich mit der lokalen Docker-Umgebung zu verbinden

Sie haben jetzt eine voll funktionsfähige Portainer-Instanz.

Schritt 5: SSL mit Reverse Proxy einrichten (Optional)

Für ein richtiges SSL-Zertifikat verwenden Sie Caddy oder Traefik als Reverse Proxy:

Caddy-Beispiel:

portainer.yourdomain.com {
    reverse_proxy localhost:9443 {
        transport http {
            tls_insecure_skip_verify
        }
    }
}

Oder mit Nginx:

server {
    listen 443 ssl;
    server_name portainer.yourdomain.com;

    ssl_certificate /etc/letsencrypt/live/portainer.yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/portainer.yourdomain.com/privkey.pem;

    location / {
        proxy_pass https://localhost:9443;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Erstellen Sie einen DNS-A-Eintrag für portainer.yourdomain.com → Ihre Server-IP.

Container bereitstellen

Bereitstellung über App-Templates

Portainer enthält über 100 integrierte Templates:

1. Gehen Sie zu App Templates in der Seitenleiste
2. Durchsuchen oder suchen Sie (WordPress, Nginx, MySQL, Redis usw.)
3. Klicken Sie auf das Template
4. Konfigurieren Sie die Einstellungen (Name, Ports, Volumes)
5. Klicken Sie auf Deploy the container

Beliebte Templates:

• WordPress — Blog/CMS mit MySQL
• Nginx — Webserver / Reverse Proxy
• PostgreSQL — Datenbankserver
• Redis — Cache / Message Broker
• GitLab CE — Git-Hosting
• Nextcloud — Selbstgehosteter Cloud-Speicher

Bereitstellung mit Docker Compose (Stacks)

Stacks sind Portainers Methode zur Verwaltung von Docker Compose Deployments:

1. Gehen Sie zu Stacks → Add Stack
2. Benennen Sie Ihren Stack
3. Fügen Sie Ihre Docker Compose YAML ein:

services:
  app:
    image: nginx:alpine
    ports:
      - "8080:80"
    volumes:
      - app_data:/usr/share/nginx/html
    restart: unless-stopped

volumes:
  app_data:

4. Klicken Sie auf Deploy the stack

Sie können Compose-Dateien auch aus einem Git-Repository laden — nützlich für GitOps-Workflows.

Einzelnen Container bereitstellen

Für schnelle Einzel-Container:

1. Gehen Sie zu Containers → Add Container
2. Legen Sie Name und Image fest (z.B. redis:alpine)
3. Konfigurieren Sie:
   • Port mapping — Host-Port → Container-Port
   • Volumes — Persistenter Speicher
   • Environment variables — Konfigurationswerte
   • Restart policy — Always, on-failure usw.
4. Klicken Sie auf Deploy the container

Container verwalten

Container-Aktionen

In der Containers-Liste können Sie:

• Start/Stop/Restart — Container-Zustand steuern
• Logs — Echtzeit-Container-Ausgabe anzeigen
• Console — In den Container einloggen (bash, sh oder benutzerdefiniert)
• Inspect — Vollständige Container-Konfiguration anzeigen
• Stats — CPU, Speicher, Netzwerk, I/O-Diagramme
• Duplicate/Edit — Container-Einstellungen klonen oder ändern

Container-Konsole

Eine der besten Funktionen von Portainer. Sie müssen etwas debuggen?

1. Klicken Sie auf den Container → Console
2. Wählen Sie die Shell: /bin/bash oder /bin/sh
3. Klicken Sie auf Connect

Sie befinden sich im Container. Kein SSH, keine docker exec-Befehle nötig.

Massenoperationen

Wählen Sie mehrere Container aus und:

• Alle ausgewählten stoppen
• Alle ausgewählten starten
• Alle ausgewählten entfernen
• Alle ausgewählten beenden

Nützlich für die gemeinsame Verwaltung zusammengehöriger Dienste.

Images verwalten

Images herunterladen

1. Images → Image-Name eingeben (z.B. node:20-alpine)
2. Klicken Sie auf Pull the image
3. Das Image wird heruntergeladen und ist einsatzbereit

Ungenutzte Images bereinigen

Docker-Images sammeln sich schnell an:

1. Images → unused images auswählen
2. Alle auswählen → Remove
3. Oder verwenden Sie den Prune-Button, um alles Ungenutzte zu bereinigen

Dies entspricht docker image prune -a, ist aber visuell und sicherer.

Volume-Verwaltung

Volumes erstellen

1. Volumes → Add Volume
2. Benennen Sie es (z.B. postgres_data)
3. Klicken Sie auf Create the volume

Volume-Inhalte durchsuchen

Portainer ermöglicht es Ihnen, Dateien innerhalb von Volumes zu durchsuchen — praktisch, um Daten zu überprüfen, ohne sich in Container einloggen zu müssen.

Volumes sichern

Für kritische Daten sichern Sie Ihre Volumes:

docker run --rm \
  -v postgres_data:/data \
  -v /backup:/backup \
  alpine tar czf /backup/postgres-backup.tar.gz -C /data .

Netzwerk-Verwaltung

Netzwerke erstellen

1. Networks → Add Network
2. Benennen Sie es, wählen Sie den Treiber (bridge, overlay, macvlan)
3. Optional Subnetz und Gateway konfigurieren
4. Klicken Sie auf Create the network

Container verbinden

Um Container miteinander kommunizieren zu lassen:

1. Öffnen Sie das Netzwerk
2. Join a container → Container auswählen
3. Jetzt können beide Container sich gegenseitig über den Namen erreichen

So verbinden Sie Ihren App-Container mit Ihrem Datenbank-Container, ohne Datenbank-Ports öffentlich freizugeben.

Multi-Server-Verwaltung

Remote-Docker-Hosts hinzufügen

Portainer kann mehrere Server über ein Dashboard verwalten:

Methode 1: Portainer Agent (empfohlen)

Auf dem Remote-Server:

docker run -d \
  -p 9001:9001 \
  --name portainer_agent \
  --restart=always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /var/lib/docker/volumes:/var/lib/docker/volumes \
  portainer/agent:sts

In Portainer:

1. Environments → Add Environment
2. Wählen Sie Agent
3. Geben Sie ein: remote-server-ip:9001
4. Benennen Sie es, klicken Sie auf Connect

Methode 2: Docker API (weniger sicher)

Aktivieren Sie Docker TCP auf dem Remote-Host und verbinden Sie sich direkt. Verwenden Sie dies nur über einen sicheren Tunnel.

Edge Agents

Für Server hinter Firewalls oder NAT:

1. Environments → Add Environment → Edge Agent
2. Kopieren Sie den generierten Installationsbefehl
3. Führen Sie ihn auf dem Remote-Server aus
4. Der Agent verbindet sich über Port 8000 zurück

Keine eingehenden Ports auf dem Remote-Server erforderlich.

Benutzerverwaltung

Teams erstellen

1. Users → Teams → Add Team
2. Benennen Sie das Team (z.B. „Developers”, „Ops”)

Benutzer hinzufügen

1. Users → Add User
2. Legen Sie Benutzername und Passwort fest
3. Weisen Sie einem Team zu
4. Rolle festlegen: Administrator oder User

Zugriffskontrolle

Zugriff pro Umgebung und pro Ressource:

• Vollzugriff — Vollständige Kontrolle
• Eingeschränkt — Nur zugewiesene Stacks/Container
• Nur Lesen — Ansehen, aber nicht ändern

So können Sie Entwicklern Zugriff auf die Staging-Umgebung geben, während die Produktion geschützt bleibt.

Portainer mit Docker Compose

Wenn Sie Portainer selbst lieber mit Compose verwalten möchten:

services:
  portainer:
    image: portainer/portainer-ce:sts
    container_name: portainer
    restart: always
    ports:
      - "8000:8000"
      - "9443:9443"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - portainer_data:/data

volumes:
  portainer_data:

Speichern Sie als docker-compose.yml und führen Sie aus:

docker compose up -d

Performance-Tipps

1. Swap aktivieren

Bei einem kleinen VPS:

fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile swap swap defaults 0 0' >> /etc/fstab

2. Ressourcenlimits festlegen

In Portainer beim Erstellen von Containern:

• Memory limit festlegen (z.B. 512MB für eine Node-App)
• CPU limit festlegen (z.B. 0,5 CPUs)

Verhindert, dass ein einzelner Container alle Ressourcen verbraucht.

3. Regelmäßige Bereinigung

Docker-Bereinigung planen:

# Zum Crontab hinzufügen
0 3 * * 0 docker system prune -af --volumes 2>&1 | logger -t docker-prune

Oder verwenden Sie die integrierte Image-Bereinigung von Portainer.

4. Alpine-Images verwenden

Verwenden Sie nach Möglichkeit alpine-Varianten:

• node:20-alpine statt node:20 (50MB vs 350MB)
• python:3.12-alpine statt python:3.12
• nginx:alpine statt nginx

Fehlerbehebung

Portainer-Oberfläche nicht erreichbar

# Prüfen, ob der Container läuft
docker ps | grep portainer

# Logs prüfen
docker logs portainer

# Port überprüfen
ss -tlnp | grep 9443

# Firewall prüfen
ufw status
ufw allow 9443

Container startet nicht

1. Logs prüfen: Containers → Container auswählen → Logs
2. Häufige Probleme:
   • Port bereits belegt → Host-Port ändern
   • Volume-Zugriff verweigert → Berechtigungen prüfen
   • Image nicht gefunden → Image-Name überprüfen

Stack-Deployment schlägt fehl

1. Überprüfen Sie die YAML-Syntax der Compose-Datei
2. Stellen Sie sicher, dass alle Images vorhanden und erreichbar sind
3. Prüfen Sie Port-Konflikte mit laufenden Containern
4. Überprüfen Sie das Deployment-Log in den Stack-Details

Kein Speicherplatz mehr

# Belegung prüfen
df -h

# Docker bereinigen
docker system prune -af --volumes

# Große Images prüfen
docker images --format "{{.Repository}}:{{.Tag}} {{.Size}}" | sort -k2 -h

Portainer im Vergleich zu Alternativen

Tool	Oberfläche	Komplexität	Am besten geeignet für
Portainer	Web-GUI	Niedrig	Container-Verwaltung
Coolify	Web-GUI	Niedrig	App-Deployment (PaaS)
Dokploy	Web-GUI	Niedrig	App-Deployment (PaaS)
Yacht	Web-GUI	Niedrig	Einfache Docker-Oberfläche
Dockge	Web-GUI	Niedrig	Reine Compose-Verwaltung
Lazydocker	Terminal	Niedrig	CLI-basiertes Monitoring

Portainer ist die beste Allzweck-Docker-Verwaltungsoberfläche. Verwenden Sie Coolify oder Dokploy, wenn Sie PaaS-Funktionen (Git-Deploy, Auto-SSL) wünschen. Verwenden Sie Portainer, wenn Sie volle Kontrolle über einzelne Container möchten.

FAQ

Wie viel RAM verbraucht Portainer?

Etwa 50-100MB. Es ist sehr ressourcenschonend.

Kann ich Docker Swarm mit Portainer verwalten?

Ja. Portainer unterstützt Docker Standalone, Docker Swarm und Kubernetes.

Ist Portainer CE wirklich kostenlos?

Ja, dauerhaft kostenlos für bis zu 5 Umgebungen. Keine Funktionseinschränkungen innerhalb von CE.

Wie aktualisiere ich Portainer?

docker stop portainer
docker rm portainer
docker pull portainer/portainer-ce:sts
docker run -d -p 8000:8000 -p 9443:9443 \
  --name portainer --restart=always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v portainer_data:/data \
  portainer/portainer-ce:sts

Ihre Daten bleiben im portainer_data-Volume erhalten.

Kann Portainer Kubernetes ersetzen?

Für kleine bis mittlere Deployments, ja. Wenn Sie weniger als 50 Container auf einigen Servern betreiben, ist Portainer mit Docker einfacher und günstiger als Kubernetes.

Zusammenfassung

Portainer verwandelt die Docker-Verwaltung von einer reinen CLI-Erfahrung in etwas Visuelles und Zugängliches. Ob Sie einige Container auf einem einzelnen VPS betreiben oder mehrere Server verwalten — Sie erhalten ein übersichtliches Dashboard ohne die Komplexität von Kubernetes.

Empfohlenes Setup:

Komponente	Auswahl	Kosten
VPS	Hostinger KVM1	$4,99/Monat
Verwaltung	Portainer CE	Kostenlos
Reverse Proxy	Caddy	Kostenlos
Gesamt		$4,99/Monat

Starten Sie hier: Holen Sie sich einen Hostinger VPS → Installieren Sie Docker → Stellen Sie Portainer bereit → Verwalten Sie alles über Ihren Browser.