Forgejo als selbst gehostete Git-Plattform
Forgejo ist interessant, wenn Quellcode und Projektzusammenarbeit auf einer eigenen Instanz bleiben sollen. Beim Betrieb zählt allerdings mehr als die Oberfläche mit Repositories und Benutzerkonten: Eine Instanz speichert Daten an mehreren Orten, die beim Umzug oder Ausfall wieder zusammenpassen müssen. Die Forgejo-Dokumentation benennt Git-Repositories und weitere Dateien auf dem Datenträger sowie eine SQL-Datenbank für Informationen über Benutzerinteraktionen. Wer nur den Git-Ordner kopiert, bekommt deshalb keinen vollständigen Projektstand zurück. Das gilt ebenso, wenn eine externe Datenbank separat betrieben wird. [1]
Die Sicherungsgrenze liegt nicht am Container
Forgejo empfiehlt nachdrücklich, den Dienst während eines Backups anzuhalten. Andernfalls lassen sich die gleichzeitig veränderten Dateien und Datenbankeinträge nicht ohne Weiteres konsistent erfassen. Bei einer Standardkonfiguration mit SQLite kann das Datenverzeichnis mehrere wichtige Bereiche einschließlich Datenbank, Repositories, Speicher, Warteschlangen und Indexern abdecken. „Standard“ ist dabei das entscheidende Wort: Konfigurierte Speicherorte können abweichen, und bei einer anderen Datenbank ist ein dafür geeignetes Datenbank-Backup notwendig. Prüfe die tatsächlich verwendeten Einstellungen, statt einen Ordnernamen aus einer fremden Anleitung zu übernehmen. [1]
Auch wenn du Forgejo in einem virtuellen System betreibst, folgt die Sicherung den Datenpfaden. Ein extern gemounteter Bereich kann außerhalb der normalen Gastsicherung liegen. Das ist derselbe Denkfehler, den der Artikel über Bind-Mounts im Proxmox-Backup behandelt. Halte deshalb fest, welche Volumes lokal, welche extern und welche von einem anderen Dienst gesichert werden. Ein Backupplan braucht für jede dieser Komponenten ein konkretes Ziel und einen Testfall.
Schlüssel sind Teil der Wiederherstellung
Eine besonders leicht übersehene Grenze betrifft die Konfiguration. Forgejo erklärt, dass Werte in der Datenbank mit dem konfigurierten SECRET_KEY verschlüsselt werden. Geht dieser Schlüssel beim Restore verloren, können etwa gespeicherte Webhook-Zugangsdaten, Actions-Secrets, Mirror-Zugangsdaten und Zwei-Faktor-Konfigurationen unbrauchbar werden. Auch ein nicht erhaltener JWT_SECRET kann erneute Authentifizierung integrierter Systeme erforderlich machen. Nutzt Forgejo einen eigenen SSH-Server, gehören dessen Hostschlüssel ebenfalls in die Sicherungsplanung; sonst sehen SSH-Clients nach dem Umzug einen anderen Hostschlüssel. Solche Geheimnisse gehören geschützt und getrennt von öffentlich lesbaren Backups verwahrt. [1]
Ein kompletter Restore verlangt also Datenbank, konfigurierte Dateispeicher und die passende app.ini samt Schlüsseln. Indexdaten können je nach Einrichtung neu aufgebaut werden; das kann aber Zeit und Ein-/Ausgabe kosten. Bei externem Objektspeicher muss auch dessen Sicherung berücksichtigt werden. Der Gewinn der selbst betriebenen Plattform ist die Kontrolle über diese Entscheidungen. Ihre Grenze ist, dass keine fremde Plattform den fehlenden Schlüssel oder den vergessenen Speicherpfad für dich rekonstruiert. [1]
Vor Updates den Rückweg proben
Lege in einer Testinstanz ein Projekt, eine kleine Änderung und einen Testzugang an. Sichere den Dienst nach dokumentiertem Verfahren, stelle ihn isoliert wieder her und kontrolliere Repository-Verlauf, Login und SSH-Verbindung. Bei einem geplanten Upgrade empfiehlt Forgejo vorab ein vollständiges Backup; beim Wechsel auf eine neue stabile Release-Reihe bezeichnet die Upgrade-Anleitung es als erforderlich. Prüfe unmittelbar danach die wichtigsten Funktionen, denn ein erst Wochen später entdeckter Fehler erschwert die Rückkehr zum alten Stand. Die Anleitung warnt außerdem vor einem einfachen Downgrade bei bereits migrierter Datenbank. [2]
Notiere vor dem Upgrade, welche Version das Backup erzeugte und wie die Testinstanz wiederhergestellt wurde. Plane einen Wiederanlauf nicht allein anhand eines grünen Sicherungsjobs. Der ergänzende Beitrag über Backup-Strategien für Selfhoster hilft, Kopien und Restore-Proben auch jenseits dieser Git-Plattform zu organisieren. Eine kleine, wirklich restaurierte Forgejo-Instanz ist mehr wert als ein großes Archiv, dessen Inhalt niemand geprüft hat.
Was ein Git-Klon nicht zurückbringt
Ein Git-Klon ist für die Codehistorie nützlich, aber nicht die Sicherung der gesamten Plattform. Prüfe bei einem isolierten Restore deshalb einen Commit und zusätzlich einen Nutzerzugang, ein Issue samt Kommentar und ein Repository mit geschützten Rechten. Diese Metadaten gehören zur Instanzdatenbank und kommen nicht aus einem bloßen Git-Klon zurück. [1]
Vor einer Versionsmigration sichere zusammengehörige Datenbank, Dateibestand und Schlüssel mit dokumentierter Forgejo-Version. Wenn der neue Stand nicht startet, kopiere nicht bloß das alte Binary über eine bereits migrierte Datenbank. Die Upgrade-Dokumentation beschreibt Downgrade-Grenzen; teste stattdessen den Restore des vor dem Upgrade gesicherten Zustands auf einer getrennten Instanz und verifiziere dort Webzugriff und Schreibfähigkeit. [2]

