Installationsleitfaden

Die Anwendung kann mit Docker, Portainer Stacks oder Podman bereitgestellt werden. Nach der Installation möchten Sie möglicherweise die Zeitzone konfigurieren, wie in Zeitzone konfigurieren beschrieben, und müssen die Duplicati-Server so konfigurieren, dass sie Sicherungsprotokolle an duplistatus senden, wie im Abschnitt Duplicati-Konfiguration dargelegt.

Voraussetzungen

Stellen Sie sicher, dass Sie über Folgendes verfügen:

Docker Engine - Installationsanleitung für Debian
Docker Compose - Installationsanleitung für Linux
Portainer (optional) - Docker-Installationsanleitung
Podman (optional) - Installationsanleitung

Authentifizierung

duplistatus ab Version 0.9.x erfordert Benutzerauthentifizierung. Ein Standard-admin-Konto wird automatisch erstellt, wenn die Anwendung zum ersten Mal installiert oder von einer früheren Version aktualisiert wird:

Benutzername: admin
Passwort: Duplistatus09

Sie können zusätzliche Benutzerkonten in Einstellungen > Benutzer nach der ersten Anmeldung erstellen.

WICHTIG

Das System erzwingt eine Mindestlänge und Komplexität des Passworts. Diese Anforderungen können mithilfe der Umgebungsvariablen PWD_ENFORCE und PWD_MIN_LEN environment variables angepasst werden. Die Verwendung eines Passworts ohne ausreichende Komplexität oder mit kurzer Länge kann die Sicherheit gefährden. Bitte verwenden Sie diese Einstellungen mit Bedacht.

Container-Images

Sie können die Bilder von:

Docker Hub: docker.io/wsjbr/duplistatus:latest
GitHub Container Registry: ghcr.io/wsj-br/duplistatus:latest

Option 1: Verwendung von Docker Compose

Dies ist die empfohlene Methode für lokale Bereitstellungen oder wenn Sie die Konfiguration anpassen möchten. Sie verwendet eine docker compose-Datei, um den Container mit allen seinen Einstellungen zu definieren und auszuführen.

# download the compose file
wget https://github.com/wsj-br/duplistatus/raw/refs/heads/master/production.yml -O duplistatus.yml
# start the container
docker compose -f duplistatus.yml up -d

Prüfen Sie den Zeitzone-Abschnitt für weitere Details zur Anpassung von Zeitzone sowie Zahlen-, Datums- und Uhrzeitformat.

Option 2: Verwendung von Portainer Stacks (Docker Compose)

Gehen Sie zu „Stacks" auf Ihrem Portainer-Server und klicken Sie auf „Stack hinzufügen".
Benennen Sie Ihren Stack (z. B. „duplistatus").
Wählen Sie „Build method" als „Web editor".
Kopieren Sie dies und fügen Sie es im Web-Editor ein:

# duplistatus production compose.yml
services:
  duplistatus:
    image: ghcr.io/wsj-br/duplistatus:latest
    container_name: duplistatus
    restart: unless-stopped
    environment:
      - TZ=Europe/London
      - PWD_ENFORCE=true
      - PWD_MIN_LEN=8
    ports:
      - "9666:9666"
    volumes:
      - duplistatus_data:/app/data
    networks:
      - duplistatus_network

networks:
  duplistatus_network:
    driver: bridge

volumes:
  duplistatus_data:
    name: duplistatus_data

Prüfen Sie den Zeitzone-Abschnitt für weitere Details zur Anpassung der Zeitzone und des Zahlen-, Datums- und Uhrzeitformats.
Klicken Sie auf "Stack bereitstellen".

Option 3: Verwendung von Portainer Stacks (GitHub Repository)

Gehen Sie in Portainer zu "Stacks" und klicken Sie auf "Stack hinzufügen".
Benennen Sie Ihren Stack (z.B. "duplistatus").
Wählen Sie "Build-Methode" als "Repository".
Geben Sie die Repository-URL ein: https://github.com/wsj-br/duplistatus.git
Geben Sie im Feld "Compose-Pfad" ein: production.yml
(optional) Legen Sie die Umgebungsvariablen TZ, LANG, PWD_ENFORCE und PWD_MIN_LEN im Abschnitt "Umgebungsvariablen" fest. Prüfen Sie den Zeitzone-Abschnitt für weitere Details zur Anpassung der Zeitzone und des Zahlen-, Datums- und Uhrzeitformats.
Klicken Sie auf "Stack bereitstellen".

Option 4: Verwendung der Docker CLI

# Create the volume
docker volume create duplistatus_data

# Start the container
docker run -d \
  --name duplistatus \
  -p 9666:9666 \
  -e TZ=Europe/London \
  -e LANG=en_GB \
  -v duplistatus_data:/app/data \
  ghcr.io/wsj-br/duplistatus:latest

Das Volume duplistatus_data wird für persistenten Speicherplatz verwendet. Das Container-Image verwendet Europe/London als Standard-Zeitzone und en_GB als Standard-Sprache.

Option 5: Podman (CLI) `rootless` verwenden

Für grundlegende Setups können Sie den Container ohne DNS-Konfiguration starten:

mkdir -p ~/duplistatus_data
# Start the container (standalone)
podman run -d \
  --name duplistatus \
  --userns=keep-id \
  -e TZ=Europe/London \
  -e LANG=en_GB \
  -p 9666:9666 \
  -v ~/duplistatus_data:/app/data \
  ghcr.io/wsj-br/duplistatus:latest

DNS für Podman-Container konfigurieren

Wenn Sie eine benutzerdefinierte DNS-Konfiguration benötigen (z. B. für Tailscale MagicDNS, Unternehmensnetzwerke oder benutzerdefinierte DNS-Setups), können Sie DNS-Server und Suchdomänen manuell konfigurieren.

Ihre DNS-Konfiguration finden:

Für systemd-resolved-Systeme (die meisten modernen Linux-Distributionen):

# Get DNS servers
resolvectl status | grep "DNS Servers:" | awk '{print "--dns " $3}'

# Get DNS search domains
resolvectl status | grep "DNS Domain:" | awk '{print "--dns-search " $3}'

Für Nicht-systemd-Systeme oder als Fallback:

cat /run/systemd/resolve/resolv.conf 2>/dev/null || cat /etc/resolv.conf

Suchen Sie nach Zeilen, die mit nameserver (für DNS-Server) und search (für Such-Domänen) beginnen. Falls Sie sich bei Ihren DNS-Einstellungen oder Netzwerk-Such-Domänen unsicher sind, wenden Sie sich an Ihren Netzwerkadministrator, um diese Informationen zu erhalten.

Beispiel mit DNS-Konfiguration:

mkdir -p ~/duplistatus_data
# Start the container with DNS configuration
podman run -d \
  --name duplistatus \
  --userns=keep-id \
  --dns 100.100.100.100 \
  --dns-search example.com \
  -e TZ=Europe/London \
  -e LANG=en_GB \
  -p 9666:9666 \
  -v ~/duplistatus_data:/app/data \
  ghcr.io/wsj-br/duplistatus:latest

Sie können mehrere DNS-Server angeben, indem Sie mehrere --dns-Flags hinzufügen:

--dns 8.8.8.8 --dns 1.1.1.1

Sie können mehrere Suchdomänen angeben, indem Sie mehrere --dns-search-Flags hinzufügen:

--dns-search example.com --dns-search internal.local

Hinweis: Überspringen Sie IPv6-Adressen (mit :) und Localhost-Adressen (wie 127.0.0.53) beim Konfigurieren von DNS-Servern.

Prüfen Sie den Zeitzone-Abschnitt für weitere Details zur Anpassung der Zeitzone und des Zahlen-, Datums- und Uhrzeitformats.

Option 6: Verwendung von Podman Pods

Podman-Pods ermöglichen es Ihnen, mehrere Container in einem gemeinsamen Netzwerk-Namespace auszuführen. Dies ist nützlich zum Testen oder wenn Sie duplistatus zusammen mit anderen Containern ausführen müssen.

Grundlegende Pod-Einrichtung:

mkdir -p ~/duplistatus_data

# Create the pod
podman pod create --name duplistatus-pod --publish 9666:9666/tcp

# Create the container in the pod
podman create --name duplistatus \
  --pod duplistatus-pod \
  --user root \
  -e TZ=Europe/London \
  -e LANG=en_GB \
  -v ~/duplistatus_data:/app/data \
  ghcr.io/wsj-br/duplistatus:latest

# Start the pod
podman pod start duplistatus-pod

DNS für Podman Pods konfigurieren

Wann Pods verwendet werden, muss die DNS-Konfiguration auf Pod-Ebene festgelegt werden, nicht auf Container-Ebene. Verwenden Sie die gleichen Methoden, die in Option 5 beschrieben sind, um Ihre DNS-Server und Suchdomänen zu finden.

Beispiel mit DNS-Konfiguration:

mkdir -p ~/duplistatus_data

# Create the pod with DNS configuration
podman pod create --name duplistatus-pod \
  --publish 9666:9666/tcp \
  --dns 100.100.100.100 \
  --dns-search example.com

# Create the container in the pod
podman create --name duplistatus \
  --pod duplistatus-pod \
  --user root \
  -e TZ=Europe/London \
  -e LANG=en_GB \
  -v ~/duplistatus_data:/app/data \
  ghcr.io/wsj-br/duplistatus:latest

# Start the pod
podman pod start duplistatus-pod

Pod verwalten:

# Stop the pod (stops all containers in the pod)
podman pod stop duplistatus-pod

# Start the pod
podman pod start duplistatus-pod

# Remove the pod and all containers
podman pod rm -f duplistatus-pod

Wesentliche Konfiguration

Konfigurieren Sie Ihre Duplicati-Server, um Backup-Protokollnachrichten an duplistatus zu senden (erforderlich).
Melden Sie sich bei duplistatus an – siehe Anweisungen im Benutzerhandbuch.
Sammeln Sie erste Backup-Protokolle – verwenden Sie die Funktion Backup-Protokolle sammeln, um die Datenbank mit historischen Sicherungsdaten von allen Ihren Duplicati-Servern zu füllen. Dies aktualisiert auch automatisch die Backup-Überwachungsintervalle basierend auf der Konfiguration jedes Servers.
Konfigurieren Sie Server-Einstellungen – richten Sie Server-Aliase und Notizen in Einstellungen → Server ein, um Ihr Dashboard informativer zu gestalten.
Konfigurieren Sie NTFY-Einstellungen – richten Sie Benachrichtigungen über NTFY in Einstellungen → NTFY ein.
Konfigurieren Sie E-Mail-Einstellungen – richten Sie E-Mail-Benachrichtigungen in Einstellungen → E-Mail ein.
Konfigurieren Sie Backup-Benachrichtigungen – richten Sie Benachrichtigungen pro Sicherung oder pro Server in Einstellungen → Backup-Benachrichtigungen ein.

Lesen Sie die folgenden Abschnitte, um optionale Einstellungen wie Zeitzone, Zahlenformat und HTTPS zu konfigurieren.

Voraussetzungen​

Authentifizierung​

Container-Images​

Option 1: Verwendung von Docker Compose​

Option 2: Verwendung von Portainer Stacks (Docker Compose)​

Option 3: Verwendung von Portainer Stacks (GitHub Repository)​

Option 4: Verwendung der Docker CLI​

Option 5: Podman (CLI) rootless verwenden​

DNS für Podman-Container konfigurieren​

Option 6: Verwendung von Podman Pods​

DNS für Podman Pods konfigurieren​

Wesentliche Konfiguration​