belegt
Health Warn
- License — License: AGPL-3.0
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Fail
- spawnSync — Synchronous process spawning in deploy/app-rolle.test.ts
- process.env — Environment variable access in deploy/app-rolle.test.ts
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
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.
Belegt: Dokumentenarchiv mit GoBD-Modus, selbst gehostet
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.
Rundgang in Bildern •
Warum? •
Funktionen •
Schnellstart •
FAQ •
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.
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
![]() 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.
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.
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]
SichereBELEGT_SCHLUESSELzusätzlich an einem zweiten Ort. Ohne ihn lassen sich Postfach-Passwörter,
Refresh-Tokens und Webhook-Geheimnisse nach einer Wiederherstellung nicht mehr lesen.
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.
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.
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.
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.
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.
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.
Die Software ist kostenlos (AGPL-3.0). Du brauchst nur einen Server.
Entwicklung
Voraussetzungen: Bun 1.4.4, PostgreSQL. Befehle, Tests und Umgebungsvariablen stehen in
Entwicklung, wie du mitmachst, in
CONTRIBUTING.md. Sicherheitslücken bitte privat melden, siehe SECURITY.md.
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.
Sterne im Verlauf
⭐ Gefällt dir Belegt? Ein Stern auf GitHub hilft anderen, es zu finden.
🐛 Fehler melden · 💡 Idee vorschlagen · 🔒 Sicherheitslücke melden
Lizenz: AGPL-3.0 · © Tristan Teufel und Mitwirkende
Wer Belegt für andere betreibt, muss ihnen den Quellcode anbieten.
Belegt ist keine Steuer- oder Rechtsberatung. Aufbewahrung und Verfahrensdokumentation vor dem Echtbetrieb mit deiner Steuerberatung abgleichen.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found



