Skip to content

Installation

Jump to bottom
blacksheep8732 edited this page Sep 18, 2026 · 2 revisions

🇬🇧 English version

Installation

TasmoBackup-py läuft als Docker-Container. Das fertige Image liegt bei GitHub:

ghcr.io/blacksheep8732/tasmobackup-py:latest

Neben latest gibt es feste Versionen wie 0.2.0 oder 0.2, falls du nicht automatisch jede neue Version bekommen möchtest.

Unraid (Community Apps)

  1. Im Unraid auf Apps gehen und nach TasmoBackup-py suchen.
  2. Install anklicken.
  3. Im Formular:
    • WebUI: Port, unter dem die Oberfläche erreichbar ist (Standard 8259).
    • Appdata: Ordner für Datenbank, Schlüssel und alle Backups (Standard /mnt/user/appdata/tasmobackup-py).
    • Admin user / Admin password: deine Anmeldung für die Weboberfläche.
  4. Apply – danach ist die Oberfläche unter http://<Unraid-IP>:8259 erreichbar.

Important

Admin user und Admin password gelten nur beim allerersten Start. Danach steht das Passwort (als nicht umkehrbarer Hash) in der Datenbank und wird unter Einstellungen geändert. Das Feld im Unraid-Formular später zu ändern bewirkt nichts – wie du ein vergessenes Passwort zurücksetzt, steht unter Fehlerbehebung.

Unter Show more settings findest du weitere Felder (Standard-Zugangsdaten für Tasmota, Schlüssel, PUID/PGID). Für die meisten Installationen kannst du sie so lassen.

Updates: Unraid zeigt im Reiter Docker „Update verfügbar“, sobald eine neue Version erscheint. Ein Klick auf Update genügt, Daten und Schlüssel bleiben erhalten.

Docker / Docker Compose

services:
  tasmobackup:
    image: ghcr.io/blacksheep8732/tasmobackup-py:latest
    container_name: tasmobackup-py
    ports:
      - "8259:8000"
    volumes:
      - ./data:/data
    environment:
      - TB_ADMIN_USER=admin
      - TB_ADMIN_PASSWORD=bitte-aendern
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Berlin
    restart: unless-stopped

Oder ohne Compose:

docker run -d --name tasmobackup-py -p 8259:8000 \
  -v /pfad/zu/daten:/data \
  -e TB_ADMIN_PASSWORD=bitte-aendern -e PUID=1000 -e PGID=1000 \
  ghcr.io/blacksheep8732/tasmobackup-py:latest

Umgebungsvariablen

Variable Standard Bedeutung
TB_ADMIN_USER admin Login-Name – nur beim ersten Start
TB_ADMIN_PASSWORD admin Login-Passwort – nur beim ersten Start
TB_SECRET_KEY (automatisch) Schlüssel für die Anmeldung und die verschlüsselten Passwörter. Leer lassen: dann wird beim ersten Start einer erzeugt und als .secret_key im Datenordner gespeichert.
TB_TASMOTA_USER / TB_TASMOTA_PASSWORD admin / (leer) Zugangsdaten für Geräte, bei denen keine eigenen hinterlegt sind
TB_AUTH_ENABLED true false schaltet den Login ab – nur hinter einem Proxy mit eigener Anmeldung sinnvoll
PUID / PGID 1000 / 1000 Benutzer/Gruppe, unter dem die App läuft (Unraid-Template: 99 / 100)
TZ – Zeitzone für die Log-Ausgaben. Die Anzeige in der Oberfläche stellst du unter Einstellungen → Zeitzone ein.
TB_DATABASE_URL (SQLite im Datenordner) andere Datenbank statt SQLite. Im fertigen Image derzeit nicht nutzbar – die Treiber für MySQL/PostgreSQL sind nicht enthalten. Leer lassen.
TB_CONCURRENCY 15 wie viele Geräte gleichzeitig angesprochen werden
TB_HTTP_TIMEOUT 15 Sekunden, die auf ein Gerät gewartet wird

Der Datenordner

Alles, was aufbewahrt werden muss, liegt im gemappten Ordner (/data im Container):

tasmobackup.db           Datenbank (Geräte, Einstellungen, Ereignisse)
.secret_key              Schlüssel (nur wenn TB_SECRET_KEY leer ist)
backups/<Gerät>/…        die Backup-Dateien
tasmota-release.json     zwischengespeicherte Tasmota-Versionsinfo

Warning

Sichere diesen Ordner mit (z. B. über das Appdata-Backup-Plugin) – einschließlich .secret_key. Ohne den Schlüssel lassen sich gespeicherte Geräte- und MQTT-Passwörter nicht mehr entschlüsseln (die Backups selbst bleiben lesbar).

Die Dateirechte richtet der Container beim Start selbst: gehört etwas im Datenordner nicht PUID:PGID, wird es automatisch umgestellt.

🏠 Start / Home

🇩🇪 Deutsch

🇬🇧 English

Repository · Issues

Clone this wiki locally