From 96e949c27a644e0276616515d411fd5101c2caf5 Mon Sep 17 00:00:00 2001
From: Christopher Kolb <christopherxkolb@yahoo.de>
Date: Fri, 13 Mar 2026 09:39:10 +0000
Subject: [PATCH] add readme

---
 README.md | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2fed38a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,54 @@
+# Gitea Backup (Docker + SQLite)
+
+Dieses Setup erstellt tägliche Backups der kompletten Gitea-Daten unter Docker.  
+Es basiert auf der offiziellen Gitea-Dokumentation, die bestätigt, dass alle relevanten Daten  
+(inkl. SQLite-Datei) im `data/`-Verzeichnis liegen, während XORM‑SQL‑Dumps  
+bekannte Restore-Probleme haben.
+
+## Features
+
+- Vollständiges Dateibackup (`/data/gitea`)
+- Automatisches tägliches Backup (03:00 Uhr)
+- TAR-Archive in `backup/output/`
+- Keine XORM-Dumps (unzuverlässig laut Doku)
+
+## Nutzung
+
+### Backup-Script
+
+`backup/backup.sh` erstellt ein TAR-Archiv des gesamten Gitea-Datenverzeichnisses:
+
+```sh
+tar -czvf "/backup/output/gitea-$(date +%Y%m%d-%H%M).tar.gz" /data/gitea
+```
+
+### Crontab
+
+`backup/crontab` führt das Backup täglich aus:
+
+```
+0 3 * * * /backup/backup.sh >> /backup/cron.log 2>&1
+```
+
+Dateirechte:
+
+```sh
+sudo chown root:root backup/crontab
+sudo chmod 644 backup/crontab
+chmod +x backup/backup.sh
+```
+
+### Restore
+
+```sh
+docker stop gitea
+tar -xzvf gitea-YYYYMMDD-HHMM.tar.gz -C ./data
+docker start gitea
+```
+
+## GitIgnore
+
+```gitignore
+backup/output/
+```
+