gerald77/borgbackup-repo-manager repository overview

⁠borgbackup-repo-manager

Webseite (React + nginx), die die BorgBackup⁠-Repos eines Servers samt ihren Archiven als sortierbare, filterbare Tabellen anzeigt. Sie gehört zusammen mit dem Image gerald77/borgbackup-repo-manager-api⁠, das borg ausführt.

• Repo-Tabelle – Archive, letztes Backup, Status (ok, überfällig, gesperrt, leer, Fehler), Größen, Verschlüsselung.
• Archiv-Tabelle – Start, Dauer, Dateien, Größen, Hostname, Benutzer, Kommandozeile.
• Aktionen (optional, standardmäßig aus) – Archive löschen (mit Vorschau), Compact, Prune (mit Vorschau), Check, Sperre aufheben. Ein ganzes Repo löschen ist nicht vorgesehen.

⁠Wichtig: keine Daten im Image

Das Image enthält nur die Webseite, keine Repos und keine Zugangsdaten. Die Repos hängt der API-Container ein. Ohne die API zeigt die Seite einen Fehler.

⁠Schnellstart

Am einfachsten mit Docker Compose (Vorlage docker-compose.yml und .env.example im Quellcode-Repository): IMAGE_PREFIX=gerald77/ und REPOS_DIR (Ordner mit den Repos) in die .env eintragen, dann docker compose pull && docker compose up -d. Die Seite ist standardmäßig unter http://127.0.0.1:8080⁠ erreichbar.

Einzeln braucht der Container die API unter dem Namen borgbackup-repo-manager-api auf Port 3011 im selben Docker-Netz:

docker run -d --name borgbackup-repo-manager \
  -p 127.0.0.1:8080:80 \
  -v /pfad/zur/htpasswd:/etc/nginx/htpasswd:ro \
  gerald77/borgbackup-repo-manager:latest

⁠Tags

⁠Einstellungen

Alle weiteren Einstellungen (AKTIONEN_ERLAUBT, UEBERFAELLIG_TAGE, BACKUP_FENSTER, …) gehören zum API-Container.

⁠Sicherheit

• Lesen ist ohne Anmeldung möglich: wer die Seite erreicht, sieht alle Repos und Archivnamen (Hostnamen, Zeiten, Größen, Kommandozeilen). Den Port deshalb nur lokal binden (127.0.0.1) oder bewusst im vertrauenswürdigen LAN freigeben.
• Aktionen verlangen eine Anmeldung (Basic-Auth über /etc/nginx/htpasswd) und sind in der API zusätzlich abgeschaltet, solange AKTIONEN_ERLAUBT nicht gesetzt ist.
• Basic-Auth sendet das Kennwort über HTTP unverschlüsselt; für den Zugriff über unsichere Netze einen Reverse-Proxy mit TLS davorsetzen.
• Archivnamen, Hostnamen und Kommandozeilen stammen aus den Repos und werden ausschließlich als Text gerendert.

⁠Lizenz und Haftungsausschluss

MIT-Lizenz (maßgeblich ist der englische Originaltext):

MIT License

Copyright (c) 2026 Gerald Brunner

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Haftungsausschluss: Die Software wird „wie besehen" ohne jegliche Gewährleistung bereitgestellt. Die Nutzung erfolgt auf eigene Gefahr; die Autoren haften nicht für Schäden oder Datenverlust, die aus der Nutzung entstehen. Das gilt besonders für die Schnittstelle borgbackup-repo-manager-api, die Archive in den eingehängten borg-Repos löscht und komprimiert.