steuy: selbst gehostete Buchhaltungssoftware für Kleinunternehmer

Kostenloses Rechnungsprogramm und Rechnungswesen für das Kleingewerbe, quelloffen und auf dem eigenen Rechner.

Website · Doku mit Suche · Screenshots · Installieren · Anleitung für Einsteiger · Häufige Fragen · Roadmap · Dokumentation

steuy ist eine Buchhaltungssoftware für Kleinunternehmer und Kleingewerbe nach § 19 UStG, die ihren Gewinn per Einnahmen-Überschuss-Rechnung (EÜR) ermitteln. Du schreibst Angebote und Rechnungen, legst Belege ab, behältst Zahlungen und Mahnungen im Blick und bekommst am Jahresende die Werte für die Anlage EÜR. Das Rechnungswesen für Selbstständige, Freiberufler und kleine Online-Shops, ohne Abo und ohne Cloud.

steuy ist selbst gehostet: Die Software läuft auf deinem eigenen Rechner, zum Beispiel einem kleinen Thin Client im Heimnetz. Deine Buchhaltungsdaten verlassen ihn nicht, es gibt kein Konto bei uns. Der Quellcode ist offen einsehbar (quelloffen, PolyForm Shield), die Nutzung im eigenen Gewerbe ist kostenlos.

steuy richtet sich vor allem an Einsteiger. Ein Rundgang erklärt beim ersten Start alle Bereiche, und Hilfetexte an den Feldern sagen, was wo hingehört. Wer von Lexware kommt, importiert seine Daten aus dem DATEV-Archiv und den Zahlungslisten.

Warning

Alpha: steuy ist noch in der Alpha-Phase und wird aktiv weiterentwickelt. Es kann noch Fehler geben. Datenmodell und Abläufe können sich von Version zu Version ändern. Das Update per Klick sichert vorher automatisch, ein zweites Exemplar auf einem anderen Gerät gehört trotzdem dazu. Prüfe die Werte der Anlage EÜR vor der Abgabe selbst oder mit deiner Steuerberatung. Was kommt, steht in der Roadmap.

Warum es steuy gibt

steuy ist von Philipp (skyplayser) und Tobi (faolan-exe) entstanden. Wir wollten nicht länger jedes Jahr rund 350 Euro für Buchhaltungssoftware ausgeben. Philipp ist technischer Betriebswirt, Tobi hat gerade sein Gewerbe eröffnet und bietet IT-Dienstleistungen und Online-Shops an. Wir haben uns zusammengesetzt, gesammelt, was uns an anderer Software gefällt, was fehlt und was zu viel ist, und daraus steuy gebaut: ohne die Funktionen, die wir mitbezahlen mussten und nie brauchten, dafür mit einer WooCommerce-Anbindung und der direkten Scanner-Anbindung. Die steuerlichen Regeln haben wir nach bestem Wissen geprüft. Das ist keine Steuerberatung.

steuy ist noch in der Alpha-Phase. Wir freuen uns über jeden, der es ausprobiert und uns Rückmeldung gibt, damit wir es gemeinsam zu einer wirklich guten, kostenlosen Software machen. Fehler und Wünsche bitte als Issue.

Live-Demo

Die Demo zeigt eine erfundene Musterfirma, einen Fotografen mit Rechnungen, Mahnungen, Belegen und Equipment-Vermietung. Ein Rundgang startet von selbst. Alle Änderungen werden alle 15 Minuten zurückgesetzt, bitte gib dort keine echten Daten ein.

🌱 Für Einsteiger gemacht

Du hast noch nie eine Buchhaltung geführt? Genau dafür ist steuy gebaut. Diese Funktionen helfen dir dabei:

• Rundgang beim ersten Start. steuy fragt nach deinen Vorkenntnissen (kompletter Anfänger, bereits mal gemacht, Experte) und zeigt dir passend dazu Schritt für Schritt, was wo ist und wofür du es brauchst. Du kannst ihn jederzeit im Profil neu starten.
• Erklärungen direkt am Feld. Ein kleines Fragezeichen neben Feldern und Fachbegriffen wie EÜR, Zuflussprinzip, Kleinunternehmergrenze oder Festschreiben erklärt sie in einfachen Worten. Wer sie nicht braucht, schaltet sie ab.
• „Zu prüfen“ als Aufgabenliste. Eine Seite sammelt alles, was noch zu tun ist: offene und überfällige Rechnungen, fällige Mahnungen, neue Belege, Entwürfe und unbezahlte Ausgaben.
• Prüfungen, bevor etwas schiefgeht. Vor dem Festschreiben einer Rechnung prüft steuy die Pflichtangaben. Unplausible Eingaben wie ein Belegdatum weit in der Zukunft oder eine falsch aufgebaute Steuernummer werden angemerkt.
• Kleinunternehmerregelung im Blick. Der Hinweis nach § 19 UStG steht automatisch auf jeder Rechnung, und das Dashboard zeigt, wie nah du an der Umsatzgrenze bist.
• Belege per Foto oder Scanner. Die Texterkennung liest Betrag und Datum aus und schlägt sie vor, du bestätigst nur noch. Mit dem Scan-Eingang landen Scans vom Scanner direkt in steuy.
• Mahnungen ohne Nachdenken. steuy sagt dir, wann eine Erinnerung fällig ist, und verschickt sie auf Wunsch automatisch.
• Wöchentliche Zusammenfassung per E-Mail, damit nichts liegen bleibt.
• Updates und Sicherung per Klick, ohne Kommandozeile.
• Installation ohne Vorkenntnisse mit der Schritt-für-Schritt-Anleitung für einen kleinen Thin Client.

Funktionen

• Angebote, Rechnungen und Lieferscheine mit fortlaufenden Nummern, Artikeln und Kunden aus der Kontaktliste. Aus einem Angebot wird mit einem Klick eine Rechnung, die Belege bleiben miteinander verknüpft. Korrekturen laufen über Rechnungskorrektur oder Storno.
• PDF/A zum Archivieren, auf Wunsch mit QR-Code für die Überweisung, und Versand per E-Mail.
• Drucklayout mit fünf Vorlagen, eigenem Logo, Farben und Schrift, mit Vorschau beim Bearbeiten.
• E-Rechnung: Jede Rechnung auf Wunsch als ZUGFeRD-PDF (EN 16931), bei Behörden als XRechnung, mit XML-Download, siehe docs/e-rechnung.md.
• Wiederkehrende Rechnungen: Vorlage für Abos und Dauerkunden, monatlich bis jährlich, mit Platzhaltern wie {monat}. Auf Wunsch automatisch festgeschrieben und per E-Mail verschickt, siehe docs/wiederkehrend.md.
• Zahlungen und Mahnwesen: Zahlungseingänge und Teilzahlungen erfassen, offene Posten sehen, Mahnungen von Hand oder automatisch verschicken.
• Belege und Ausgaben: Belege hochladen oder fotografieren, die Texterkennung schlägt Betrag und Datum vor. Jede Datei wird mit Prüfsumme gespeichert und nie überschrieben.
• Scan-Eingang: Dein Scanner (z. B. Brother ADS-1800W) speichert über eine eingebaute Netzwerkfreigabe direkt in steuy, die Scans werden automatisch zu Belegen. In den Einstellungen mit einem Haken ein- und ausschaltbar, siehe docs/scanner.md.
• EÜR und Dashboard: Auswertung nach Zahlungsdatum (Zuflussprinzip), Jahresübersicht, Jahresziel und die Werte für die Anlage EÜR. Dazu Anlagegüter mit Abschreibung.
• Umzug von Lexware: Import aus dem DATEV-Archiv und aus CSV-Zahlungslisten.
• WooCommerce: Bestellungen aus dem eigenen Shop übernehmen.
• Sicherheit und Nachvollziehbarkeit: Rollen und Rechte, Anmeldung per Passkey oder Passwort mit Zwei-Faktor, festgeschriebene Buchungen lassen sich nicht mehr ändern (GoBD).
• Updates aus der App heraus, mit automatischer Sicherung vorher.

Eine Installation gehört genau einem Gewerbe. Alle Beträge werden auf den Cent genau gerechnet.

Haftung

steuy ist keine Steuerberatung, die Nutzung erfolgt auf eigene Gefahr. Für Datenverlust, steuerliche Nachteile, falsche Werte oder Sicherheitslücken wird keine Haftung übernommen. Prüfe die Werte der Anlage EÜR vor der Abgabe selbst oder mit deiner Steuerberatung, übertragen wird von Hand in ELSTER. Und sichere deine Daten regelmäßig (siehe Betrieb).

Lizenz

steuy steht unter der PolyForm Shield License 1.0.0. Du darfst die Software in deinem Gewerbe nutzen, den Code lesen und anpassen. Nicht erlaubt ist, steuy oder eine Abwandlung davon als konkurrierendes Produkt oder als Dienst anzubieten. Sicherheitslücken meldest du bitte vertraulich, siehe SECURITY.md.

Screenshots

Dashboard mit offenen Posten, Jahresziel und Rechnungsstatus	Rechnung erstellen
Rechnung als PDF im Layout „Modern“	Rechnung mit Mahnungen und Zahlungen
Was noch zu erledigen ist	Einnahmen-Überschuss-Rechnung
Angebote	Drucklayout

Mindestanforderungen

steuy läuft auf jedem kleinen Linux-Rechner, der dauerhaft eingeschaltet bleibt: Mini-PC, gebrauchter Thin Client, Proxmox-Container oder Server.

	Minimum	Empfohlen
Prozessor	1 Kern, 64 Bit (x86_64)	2 bis 4 Kerne
Arbeitsspeicher	1 GB	2 GB oder mehr
Speicherplatz	10 GB	20 GB oder mehr auf einer SSD, dazu Platz für Sicherungen
Betriebssystem	Debian 12 oder Ubuntu 24.04	Debian 13 oder Ubuntu 24.04 und neuer
Netzwerk	LAN mit fester IP-Adresse im Heimnetz	zusätzlich ein zweites Gerät für Sicherungen

Im Betrieb belegen App und Datenbank zusammen etwa 400 bis 700 MB Arbeitsspeicher. Am meisten Rechenleistung brauchen die PDF-Erzeugung und die Texterkennung, die sich abschalten lässt.

Ein gebrauchter Dell Wyse 5070 mit 4 bis 8 GB RAM und SSD passt gut und braucht wenig Strom. Ein Wyse 3040 geht auch, ist aber knapp: Er hat nur 2 GB RAM und 8 oder 16 GB fest verbauten Speicher, Sicherungen müssen auf ein externes Laufwerk.

Installieren

Wenn du noch nie einen Server eingerichtet hast, nimm die Anleitung für Einsteiger. Sie führt Schritt für Schritt vom leeren Thin Client oder Mini-PC bis zum laufenden steuy.

Weg	Passt, wenn	Anleitung
Thin Client oder Mini-PC	du bei null anfängst	docs/thinclient.md
Proxmox-Container (LXC)	du schon einen Proxmox-Server hast	docs/lxc.md
Docker	du einen Linux-Rechner mit Docker hast	unten, Details in docs/betrieb.md
Ohne Docker	du Python und PostgreSQL selbst verwalten möchtest	docs/betrieb.md, Abschnitt „Ohne Docker“

Schnellstart mit Docker:

git clone https://github.com/faolan-exe/Steuy.git steuy && cd steuy
printf 'SECRET_KEY=%s\nPOSTGRES_PASSWORD=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 16)" > .env
docker compose up -d --build   # http://127.0.0.1:8000

HTTPS, Updates und Sicherungen beschreibt docs/betrieb.md.

Entwicklung

Voraussetzungen: uv, PostgreSQL 17 und Pango für die PDF-Erzeugung (ADR 0008). macOS: brew install uv postgresql@17 pango tesseract, Debian/Ubuntu: apt install libpango-1.0-0 libpangoft2-1.0-0 tesseract-ocr tesseract-ocr-deu. Tesseract ist optional und liest Belegfotos und Scans aus. PostgreSQL geht auch per Docker (siehe unten).

git config core.hooksPath .githooks
chmod +x .githooks/pre-push
uv sync
cp .env.example .env          # SECRET_KEY eintragen
createdb steuy
createdb steuy_test
uv run flask db upgrade
uv run flask run --debug      # http://127.0.0.1:5000

Der Hook blockt direkte Pushes auf main lokal.

PostgreSQL per Docker statt lokal:

docker compose -f docker-compose.dev.yml up -d

Dann die beiden Datenbank-URLs in der .env wie in docker-compose.dev.yml beschrieben setzen.

Tests und Lint:

uv run pytest
uv run ruff check . && uv run ruff format --check .

Beides läuft auch in der CI.

Dokumentation

• CONTRIBUTING.md: Regeln für die Mitarbeit
• docs/faq.md: Häufige Fragen und Antworten
• docs/roadmap.md: Was steuy kann und was als Nächstes kommt
• docs/thinclient.md: Installation für Einsteiger auf einem Thin Client
• docs/scanner.md: Scanner anbinden (Brother ADS-1800W)
• docs/betrieb.md: Betrieb, Sicherung und Wiederherstellung
• docs/ziel.md: Umfang und offene Fragen
• docs/architektur.md: Aufbau und Datenmodell
• docs/domain/: Fachregeln (GoBD, EÜR, Zahlungen, Rollen, WooCommerce)
• docs/adr/: getroffene Entscheidungen

In English

steuy is a free, self-hosted accounting and invoicing application for small businesses and sole proprietors in Germany who use the small-business scheme (Kleinunternehmerregelung, § 19 UStG) and report their profit by cash-basis accounting (EÜR). It covers quotes, invoices and delivery notes, payment tracking and dunning, receipt management (including scan-to-folder from a network scanner) and the figures for the annual tax form. It runs on your own hardware, for example a small thin client, and your data never leaves your server. The source code is available under the PolyForm Shield License 1.0.0 (source-available, not OSI open source). The user interface and documentation are in German. See the live demo.

---

Idee und Konzeption: skyplayser. Umsetzung mit Claude AI.