Skip to content
SpeicherstadtPublic

About

Self-hosted document archive with GoBD mode: emails, e-invoices (ZUGFeRD, XRechnung), scans with OCR and any file, immutable until retention ends. Selbst gehostetes, revisionssicheres Dokumentenarchiv nach GoBD mit Prüferzugang, Hash-Kette und RFC-3161-Zeitstempel.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

6 stars

Watchers

0 watching

Forks

Latest commit

 

History

293 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Belegt: Dokumentenarchiv mit GoBD-Modus, selbst gehostet

Startseite von Belegt: Eingang, Archiv, offener Löschantrag, Sperre und Speicher, Fristen, Quellen, Zustand der Hash-Kette und eine gespeicherte Ansicht

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.

Status: Beta CI Lizenz: AGPL-3.0 Doku GoBD E-Rechnung

Warum? • Funktionen • Schnellstart • FAQ • Dokumentation • Entwicklung

🖼️ Rundgang in Bildern

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.

Warum Belegt?

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

Funktionen

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

Screenshots

Archiv mit der Suche nach „Rechnung“: Mail, XRechnung, Rechnung des Holzhandels und Stromrechnung mit Korrespondent, Typ, Tags und Frist
Suche: Volltext mit Filtern und Tags
ZUGFeRD-Rechnung mit PDF-Vorschau, Nummer, Datum, Verkäufer, Gesamtbetrag, Prüfung gültig und Vorschlag zur Einordnung
E-Rechnung: erkannt, geprüft und vorgeschlagen
Fristen nach § 147 AO mit einem offenen Löschantrag, der auf die zweite Person wartet
Fristen: Löschen mit zweiter Person
Prüfung: Kette intakt, Prüfbericht mit Prüfwert und Datenträger für die Betriebsprüfung
Prüfung: Prüfbericht und Datenträger (Z3)

Mehr im Rundgang in Bildern.

Belegt und die Alternativen

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

Schnellstart

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.

1. Von einem Agenten aufsetzen lassen

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.“

2. Manuell

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 .env

Trag 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 server

Mit 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.

FAQ

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.

Dokumentation

Alles im Detail, mit Suche: belegt.store (auf Deutsch). Jede Funktion oben verlinkt ihre Seite; dazu kommen:

Entwicklung

TypeScript Bun Hono React TanStack Tailwind CSS Vite PostgreSQL

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 Server

Belegt nutzt den GoBD-Kern (@firsttris/gobd-kern) aus Haben, der Open-Source-Buchhaltung desselben Projekts.

Mehr von uns

Weitere Open-Source-Apps für deinen eigenen Server, etwa für Buchhaltung, Mail, Office-Dokumente und mehr: speicherstadt.app

Mitwirken

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.

Sterne im Verlauf

Verlauf der GitHub-Sterne von Belegt

⭐ 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.

About

Self-hosted document archive with GoBD mode: emails, e-invoices (ZUGFeRD, XRechnung), scans with OCR and any file, immutable until retention ends. Selbst gehostetes, revisionssicheres Dokumentenarchiv nach GoBD mit Prüferzugang, Hash-Kette und RFC-3161-Zeitstempel.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages