Belegt ist, was du beweisen kannst.
Mails, E-Rechnungen, Scans und beliebige Dokumente an einem Ort, durchsuchbar, auf deinem Server. Was aufbewahrt
werden muss, bleibt bis Fristende unverändert, und danach löschst du es nachweisbar.
Warum? • Funktionen • Schnellstart • FAQ • Dokumentation • Entwicklung
English: self-hosted document archive with a GoBD mode for German businesses: mails (IMAP, JMAP, Microsoft 365, Google, SMTP journal, PST), e-invoices (ZUGFeRD, XRechnung), scans with OCR and any other file, immutable until the end of the legal retention period, with auditor access and the data medium for tax audits. The app is in German and English; the documentation is in German.
Warning
Beta: Belegt wird noch stark weiterentwickelt. Vor jedem Update sichern (Sichern); Migrationen lassen sich nicht zurückspielen.
Wer ein Unternehmen führt, muss Rechnungen, Kontoauszüge und Geschäftsbriefe sechs, acht oder zehn Jahre aufbewahren, unverändert und auffindbar, und der Betriebsprüfung zeigen können. Ein Ordner auf dem Server oder ein Dokumentenmanagement reicht dafür selten: Dateien lassen sich ändern, und niemand weiß, wann was gelöscht werden darf.
- Unveränderbar, wo es zählt: Siegel und Hash-Kette liegen in PostgreSQL, nicht nur in der App; auf Wunsch S3 mit Object Lock bis Fristende und ein täglicher Zeitstempel nach RFC 3161
- Fristen statt Bauchgefühl: Belegt rechnet die Frist nach § 147 AO, sperrt bis dahin und lässt danach nur mit einer zweiten Person löschen; der Nachweis bleibt
- Alles an einem Ort: Mails aus Postfach, Journal oder Outlook-Datei, E-Rechnungen, Scans mit Texterkennung und beliebige Dateien, durchsuchbar
- Bereit für die Prüfung: Prüferzugang mit Zeitraum, Datenträger nach dem Beschreibungsstandard, Prüfbericht und eine Verfahrensdokumentation, die sich selbst aktuell hält
- Offen für andere Programme: REST-API, Webhooks, MCP für KI-Assistenten, Anmeldung über OpenID Connect und Einbetten in ein Portal
- Deine Daten bleiben bei dir: eigener Server, Geheimnisse verschlüsselt, KI-Vorschläge nur mit einem Modell auf deinem Server
Kurz je Bereich; die Details stehen auf der verlinkten Seite, alles auf einen Blick unter Alle Funktionen.
| Bereich | Was Belegt kann |
|---|---|
| 📥 Eingang | Hochladen, Foto mit dem Handy, Teilen an die installierte App, Scanner per FTP mit Trennblättern, Postfächer per IMAP, JMAP, Microsoft 365 und Google, SMTP-Journal, EML, MBOX und PST |
| 🔎 Suche | Volltext in PDFs, Office-Dateien, Mails und Scans (Texterkennung), fortlaufende Archivnummer |
| 🏷️ Ordnung | Korrespondenten, Tags, Dokumenttypen und eigene Felder, Zuordnungsregeln und gelernte Vorschläge, gespeicherte Ansichten |
| 🧾 E-Rechnungen | XRechnung und ZUGFeRD erkannt, als Vorschlag zur Einordnung, auf Wunsch mit dem KoSIT-Validator geprüft |
| ⏳ Fristen und Löschen | Fristen nach § 147 AO, Sperren bei Außenprüfung oder Rechtsstreit, Löschen nach Fristende mit zweiter Person |
| 🔒 Prüfung | Siegel und Hash-Kette in PostgreSQL, Prüfbericht, Prüferzugang (Z1), Datenträger mit index.xml (Z3), Zeitstempel nach RFC 3161 |
| 📘 Verfahrensdokumentation | Aus dem tatsächlichen Stand erzeugt, mit deinen Angaben und den Lücken, die noch fehlen |
| ⚙️ Workflows | Tags, Typ, Felder, Notiz, Webhook oder Original an eine Adresse, wenn ein Dokument ankommt oder eingeordnet wird |
| 🔌 Schnittstellen | REST-API mit OpenAPI, API-Tokens, signierte Webhooks, MCP für Claude und andere Assistenten |
| 🔐 Zugänge | Inhaber, Steuerberatung, Prüfer und Mitarbeiter mit Sichtbereich, zweiter Faktor, OpenID Connect und Einbetten, Teilen per Link |
| 📦 Umzug | Aus Paperless-ngx über die API oder einen Export, mit Tags, Feldern und Notizen |
| 🌍 Oberfläche | Deutsch und Englisch, hell, dunkel oder nach dem Gerät, als App installierbar, gegen WCAG 2.2 AA geprüft |
![]() Suche: Volltext mit Filtern und Tags |
![]() E-Rechnung: erkannt, geprüft und vorgeschlagen |
![]() Fristen: Löschen mit zweiter Person |
![]() Prüfung: Prüfbericht und Datenträger (Z3) |
Mehr im Rundgang in Bildern.
| Was es ist | Was Belegt anders macht | |
|---|---|---|
| Paperless-ngx | selbst gehostetes Dokumentenmanagement mit Texterkennung und Suche | dasselbe Ablegen und Suchen, dazu Fristen nach § 147 AO und Unveränderbarkeit in PostgreSQL; Umzug mit Tags, Feldern und Notizen |
| Ordner auf dem Server | Dateiablage im Dateisystem oder auf einem Netzlaufwerk | Siegel und Hash-Kette statt änderbarer Dateien, gesperrt bis Fristende, Löschen nur mit zweiter Person und Nachweis |
Belegt läuft als Container (tristanteu/belegt, amd64 und arm64) neben PostgreSQL; ein zweiter Container aus demselben
Image ruft Postfächer ab, liest Text und stellt Webhooks zu. Du brauchst einen Server mit Docker oder Podman. Die
Images erscheinen mit dem ersten Release auf Docker Hub und GHCR.
Gib Claude Code oder einem anderen Coding-Agenten dieses Repository und SSH-Zugang zu deinem Server und sag: „Setz Belegt auf meinem Server auf, nach der Installationsanleitung.“
mkdir belegt && cd belegt
curl -O https://raw.githubusercontent.com/Speicherstadt/belegt/main/deploy/compose.yml
curl -o .env https://raw.githubusercontent.com/Speicherstadt/belegt/main/deploy/compose.env.example
chmod 600 .envTrag in .env die Geheimnisse ein (POSTGRES_PASSWORD, APP_DB_PASSWORD, BETTER_AUTH_SECRET,
BELEGT_SCHLUESSEL); die App arbeitet dann mit einer eigenen Datenbankrolle, die keine Sperre abschalten kann. Dann:
docker compose up -d
docker compose logs serverMit dem Einrichtungscode aus dem Log legst du unter BELEGT_URL (Port 3000) das erste Konto an, den Inhaber. Weitere
Dienste sind Profile (docker compose --profile <name> up -d): https (Caddy), backup (tägliche Sicherung mit
Test-Restore), journal (SMTP-Journal), ftp (für Scanner), validator (E-Rechnungen prüfen), vorschau
(Office-Dateien als PDF) und ki (Sprachmodell). S3, Zeitstempel, Microsoft 365, Google und OpenID Connect stehen in
Installation und Betrieb.
Important
Sichere BELEGT_SCHLUESSEL zusätzlich an einem zweiten Ort. Ohne ihn lassen sich Postfach-Passwörter,
Refresh-Tokens und Webhook-Geheimnisse nach einer Wiederherstellung nicht mehr lesen.
Keinen eigenen Server oder keine eigene IT? Belegt gibt es auf Anfrage gehostet oder über einen IT-Dienstleister aus dem Partnerprogramm.
Ist Belegt GoBD-konform?
Belegt setzt die technischen Anforderungen um: Unveränderbarkeit per Datenbank, Hash-Kette, Fristen, Löschen mit Nachweis, Prüferzugang und Datenträger. Zur Ordnungsmäßigkeit gehören außerdem dein Betrieb (Sicherung, Zugänge, Abläufe) und deine Verfahrensdokumentation. Ein Testat für die Software gibt es nicht; was eine Prüfung braucht, steht in Unterlagen für ein Testat.
Ist das ein Dokumentenmanagement wie paperless?
Es kann das Gleiche (hochladen, Texterkennung, Suche, einordnen), aber mit einem anderen Ziel: Belegt beweist, dass ein Dokument seit dem Eingang unverändert ist, und weiß, wie lange es aufbewahrt werden muss. Was nicht aufbewahrt werden muss, legst du „frei“ ab und löschst es, wann du willst. Aus Paperless-ngx ziehst du mit allen Dokumenten, Tags, Feldern und Notizen um, siehe Von Paperless-ngx zu Belegt.
Kann ich Mails aus Microsoft 365, Google oder Outlook archivieren?
Ja: Postfächer per OAuth (Microsoft 365, Google), IMAP oder JMAP abrufen, alle Mails per SMTP-Journal vom Mailserver bekommen, oder eine PST-Datei aus Outlook importieren. Siehe Eingang, Mails und Suche.
Wo liegen meine Dokumente, und was sieht eine KI?
Auf deinem Server, im Dateisystem oder in deinem S3-Bucket. Vorschläge eines Sprachmodells gibt es nur, wenn du eines einrichtest, und es gehört auf deinen eigenen Server (etwa Ollama); die Verfahrensdokumentation nennt Modell, Server und was es bekommt.
Kann meine Steuerberatung oder die Betriebsprüfung damit arbeiten?
Ja, über eine Einladung: Die Steuerberatung liest und bestätigt Löschungen als zweite Person; ein Prüfer sieht nur Dokumente seines Zeitraums und lädt den Datenträger herunter. Mitarbeiter sehen nur Dokumente bestimmter Tags, Typen oder Korrespondenten und ordnen sie auf Wunsch ein. Siehe Prüfung, Z1 und Z3 und Zugänge.
Kann ich Claude oder andere Programme anbinden?
Ja: per MCP suchen und lesen KI-Assistenten im Archiv, mit dem Recht „schreiben“ nehmen sie auch auf und ordnen ein; löschen kann keiner. Für eigene Programme gibt es REST-API, Webhooks und API-Tokens. Siehe Schnittstellen.
Was kostet Belegt?
Die Software ist kostenlos (AGPL-3.0). Du brauchst nur einen Server.
Alles im Detail, mit Suche: belegt.store (auf Deutsch). Jede Funktion oben verlinkt ihre Seite; dazu kommen:
- Einstieg: Rundgang in Bildern, alle Funktionen, Installation und Betrieb und Zu Hause betreiben
- Arbeiten mit Belegt: Eingang, Mails und Suche, Scannen, Von Paperless-ngx zu Belegt, Fristen und Löschen, Prüfung, Z1 und Z3 und Verfahrensdokumentation
- Schnittstellen: Programme, Webhooks, MCP und REST-API
- Hintergrund: Glossar, Unterlagen für ein Testat, Entwicklung und Plan
Voraussetzungen: Bun 1.4.4, PostgreSQL. Befehle, Tests und Umgebungsvariablen stehen in Entwicklung.
bun install
bun run dev:server # Server auf Port 3000
bun run dev:app # Oberfläche mit Vite
bun run test # Vitest, mit TEST_DATABASE_URL auch gegen PostgreSQL
bun run e2e # Playwright mit axe gegen einen echten ServerBelegt nutzt den GoBD-Kern (@firsttris/gobd-kern) aus Haben, der
Open-Source-Buchhaltung desselben Projekts.
Weitere Open-Source-Apps für deinen eigenen Server, etwa für Buchhaltung, Mail, Office-Dokumente und mehr: speicherstadt.app
Fehler und Ideen gern als Issue, mit dem Formular für Fehlerberichte oder für Funktionswünsche. Sicherheitslücken bitte privat melden, siehe SECURITY.md. Wie du mitmachst, steht in CONTRIBUTING.md.
⭐ Gefällt dir Belegt? Ein Stern auf GitHub hilft anderen, es zu finden.
Fehler melden · Idee vorschlagen
Lizenz: AGPL-3.0 · © Tristan Teufel und Mitwirkende
Wer eine veränderte Fassung von Belegt für andere übers Netz betreibt, muss ihnen den Quellcode anbieten (§ 13 AGPL).
Für IT-Dienstleister und Hoster: Partnerprogramm.
Belegt ist keine Steuer- oder Rechtsberatung. Aufbewahrung und Verfahrensdokumentation vor dem Echtbetrieb mit deiner Steuerberatung abgleichen.
Paperless-ngx ist ein Projekt seiner Entwickler; Belegt steht mit ihm in keiner Verbindung.



