← Zurück zum Portfolio
Beta v0.1.0 Tools & Automatisierung

ZenVault

Selbst gehostetes Dokumentenarchiv

Rechnungen, Verträge, Bescheide und Belege an einem Ort, durchsuchbar und automatisch sortiert. ZenVault läuft auf deinem eigenen Server, im Homelab oder auf einem Mini-PC und ist von unterwegs sicher über Tailscale erreichbar.

Stack
FastAPI, PostgreSQL, Tesseract OCR, Chrome Extension, Android, Tailscale

Funktionen

Was ZenVault macht

  1. 01

    Texterkennung auf dem eigenen Server

    Scans und Fotos werden mit Tesseract und ocrmypdf in durchsuchbare PDF/A-Dateien umgewandelt. Kein Dokument verlässt dafür das eigene Netz.

  2. 02

    Volltextsuche mit deutscher Wortstammerkennung

    Suche über Titel, Inhalt, Dateinamen und Rechnungsnummern. Tippfehler und Wortformen werden berücksichtigt.

  3. 03

    Rechnungen verstehen

    Datum, Fälligkeit, Betrag, IBAN und Rechnungsnummer werden automatisch ausgelesen. Offene Zahlungsziele stehen gesammelt unter Fälligkeiten.

  4. 04

    Sortieren nach eigenen Regeln

    Eine Regel wie „Text enthält Stadtwerke“ setzt Korrespondent, Tags, Sammlung und einen Titel nach Vorlage. Ein Test zeigt vorher, auf wie viele Dokumente sie zutrifft.

  5. 05

    Lernt aus deinen Entscheidungen

    Ein lokales Modell wertet geprüfte Dokumente aus und schlägt Zuordnungen für neue Dokumente vor. Ohne Cloud-KI.

  6. 06

    Mehrere Benutzer, getrennte Archive

    Jeder Benutzer hat ein eigenes Archiv. Geräte verbinden sich mit eigenen Zugriffstoken, die sich einzeln widerrufen lassen.

Clients

Vier Wege ins Archiv

  1. 01

    Web-Oberfläche

    Drag and Drop, Posteingang, Stapelbearbeitung, Regeleditor und PDF-Vorschau im Browser.

  2. 02

    Chrome-Erweiterung

    Aktuelle Seite oder PDF mit einem Klick archivieren, erkannte Rechnungs-Downloads übernehmen, im Popup suchen.

  3. 03

    Android-App

    Dokumente mit Kantenerkennung scannen, Dateien aus jeder App teilen, Uploads offline zwischenspeichern.

  4. 04

    Consume-Ordner und E-Mail

    Netzwerkscanner legen Dateien in einem Ordner ab, Anhänge aus einem IMAP-Postfach werden automatisch importiert.

Technik

Architektur & Stack

Server
Python 3.12, FastAPI, PostgreSQL mit Volltextindex
Texterkennung
Tesseract, ocrmypdf, Ausgabe als PDF/A
Installation
Docker Compose oder Installationsskript für Debian, Ubuntu und Proxmox-LXC
Fernzugriff
Tailscale mit HTTPS, keine offenen Ports am Router
Clients
Web, Chrome-Erweiterung (Manifest V3), Android ab Version 8
Datenhaltung
Ausschließlich auf dem eigenen Server, tägliches Datenbank-Backup
Mindestausstattung
2 CPU-Kerne, 2 GB RAM, empfohlen 4 GB
Lizenz
ZVL-1.0: private Nutzung kostenlos, keine kommerzielle Nutzung, keine Veränderung. Kommerziell auf Anfrage

Installation

Einrichten in wenigen Minuten

Auf Debian, Ubuntu oder in einem Proxmox-Container als root ausführen. Das Skript richtet Datenbank, Texterkennung, Dienste, Backup und auf Wunsch Tailscale ein.

curl -fsSL https://www.zenkner-technology.de/zenvault/install.sh | bash -s -- --tailscale

Mit Docker:

curl -fsSL https://www.zenkner-technology.de/zenvault/zenvault-latest.tar.gz | tar -xz
cd zenvault && cp .env.example .env && docker compose up -d --build

Downloads

Server, Erweiterung und Anleitung

  • ZenVault ServerRelease-Paket mit Web-Oberfläche, Docker-Dateien und Proxmox-Skript
    tar.gz herunterladen
  • InstallationsskriptFür Debian, Ubuntu und Proxmox-LXC
    install.sh
  • EinrichtungsanleitungInstallation, Tailscale, Browser, App, Backup und Fehlerbehebung als PDF
    PDF öffnen
  • Chrome-Erweiterung Im Chrome Web Store in Vorbereitung. Bis dahin als Paket zum manuellen Laden unter chrome://extensions mit aktiviertem Entwicklermodus.
  • Android-AppErscheint in Kürze im Google Play Store.
    Bald bei Google Play

Interesse an ZenVault oder etwas Ähnlichem?

Schreib mir kurz, worum es geht. Du bekommst innerhalb eines Werktags eine persönliche Rückmeldung.