Erpnext Germanized

ERPNext für deutsche Unternehmen als fertiges Container-Image: ERPNext 16 mit HRMS, ERPNext Germany, DATEV-Export, E-Rechnung (XRechnung/ZUGFeRD), Banking und Steuerbote (ELSTER), versioniert in der GitHub Container Registry.

Install Erpnext Germanized

bench get-app https://github.com/encircle360-oss/erpnext_germanized

Tags

  • buchhaltung
  • container-image
  • datev
  • deutschland
  • docker
  • elster
  • erp
  • erpnext
  • frappe
  • germany
  • ghcr
  • xrechnung
  • zugferd

Add the Frappe Gems badge to your README

Maintain Erpnext Germanized? Paste this into your README:

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=encircle360-oss%2Ferpnext_germanized)](https://frappegems.com/gems/apps/encircle360-oss/erpnext_germanized)

About Erpnext Germanized

erpnext_germanized

ERPNext für deutsche Unternehmen als fertiges Container-Image: Frappe, ERPNext und HRMS mit den deutschen Apps von ALYF und Steuerbote in einem versionierten Image für die GitHub Container Registry.

> Status: erstes Release, frühes Stadium. Das Image ghcr.io/encircle360-oss/erpnext_germanized:16.60.0-2 enthält alle Apps aus der Tabelle unten und besteht den Site-Test der CI. Es ist für Tests und erste Installationen gedacht; Rückmeldungen über Issues, Discussions oder Matrix sind willkommen, siehe Roadmap.

Steuermeldungen an ELSTER übernimmt die enthaltene App Steuerbote, zuerst die Umsatzsteuer-Voranmeldung. Steuerbote verweist in seinem README umgekehrt auf dieses Image.

Was erpnext_germanized ist

  • Ein Image. Frappe, ERPNext, HRMS, die Apps von ALYF und Steuerbote stecken zusammen in ghcr.io/encircle360-oss/erpnext_germanized. Backend, Frontend, Websocket, Worker und Scheduler starten aus demselben Image mit unterschiedlichen Befehlen, wie bei den Images von frappe_docker.
  • Deutsche Apps. Registerangaben, Prüfung der USt-IdNr., Summen- und Saldenliste, DATEV-Export, E-Rechnungen nach XRechnung und ZUGFeRD, Bankanbindung und die Umsatzsteuer-Voranmeldung kommen als eigene Apps dazu, siehe Enthaltene Apps.
  • Versionen aus apps.json. Jede App ist auf ein Release-Tag gepinnt, nie auf einen Branch. apps.json ist die einzige Liste der Apps. Das Tag von Frappe steht als Vorgabe von FRAPPE_BRANCH im Containerfile.
  • Updates durch Tag-Wechsel. Ein Update ist ein anderes Image-Tag und danach bench migrate. Sites, Dateien und Datenbank liegen in Volumes und bleiben erhalten.
  • Site-Test in der CI. Vor jeder Veröffentlichung installiert die CI alle Apps auf einer frischen Site und prüft, dass das Backend antwortet. Ein Image, das den Test nicht besteht, wird nicht veröffentlicht.
  • SBOM und Provenance. Zu jedem veröffentlichten Image erzeugt die CI eine Stückliste der enthaltenen Pakete (SBOM) und eine signierte Herkunftsangabe (Build Provenance), die gh attestation verify prüft.
  • Nur linux/amd64. Ein Image für linux/arm64 gibt es noch nicht, siehe Roadmap.

Enthaltene Apps

Frappe ist das Framework unter allen Apps. Die Apps stehen in der Reihenfolge von apps.json, in der sie auch installiert werden.

App Version Zweck Lizenz
frappe v16.60.2 Full-Stack-Webframework mit Python und MariaDB, auf dem ERPNext und alle anderen Apps laufen. MIT
erpnext v16.60.0 ERP-System mit Buchhaltung, Auftragsabwicklung und Lager, Fertigung, Anlagenverwaltung und Projekten. GPL-3.0
hrms v16.60.0 Personal und Lohn (Frappe HR) mit Mitarbeiterverwaltung, Urlaub und Anwesenheit, Spesen, Leistungsbeurteilung und Gehaltsabrechnung. GPL-3.0
erpnext_germany v16.2.2 Deutsche Anpassungen wie Summen- und Saldenliste, Zusammenfassende Meldung, Registerangaben, Prüfung der USt-IdNr., Geschäftsbriefe, Dienstreisen und GDPdU-Export. GPL-3.0
erpnext_datev v16.0.2 Schickt Belege beim Buchen per E-Mail an DATEV Unternehmen Online und exportiert Buchungen im DATEV-CSV-Format. GPL-3.0
eu_einvoice v16.4.0 Erstellt und liest E-Rechnungen im Format UN/CEFACT CII in den Profilen BASIC, EN 16931, EXTENDED und XRECHNUNG, außer bei XRECHNUNG auch eingebettet in ein PDF (ZUGFeRD, Factur-X). GPL-3.0-or-later
erpnext_pdf-on-submit v16.3.1 Erzeugt beim Buchen eines Belegs ein PDF und hängt es an den Beleg. GPL-3.0-or-later
banking v16.6.4 Holt Bankumsätze per EBICS in ERPNext und gleicht sie mit Belegen ab, wobei EBICS ein Abonnement bei ALYF braucht und der Abgleich nicht. GPL-3.0
steuerbote v0.1.2 Steuermeldungen aus ERPNext an ELSTER, zuerst die Umsatzsteuer-Voranmeldung, noch in Entwicklung und nicht einsatzfähig. AGPL-3.0-or-later

Was jede App mitbringt und wo sie eingerichtet wird, steht in Apps.

Schnellstart

Du brauchst Docker mit dem Compose-Plugin auf einem Rechner mit linux/amd64. Das Beispiel nutzt das Tag 16, also das neueste Release mit ERPNext 16; für den Dauerbetrieb trägst du unter x-erpnext das volle Tag ein, etwa 16.60.0-1, siehe Versionen und Updates.

  1. Lege ein Verzeichnis an und hol das Beispiel examples/compose.yaml:

    mkdir erpnext && cd erpnext
    curl -fsSLO https://raw.githubusercontent.com/encircle360-oss/erpnext_germanized/main/examples/compose.yaml
    
  2. Ersetze in compose.yaml unter x-site beide CHANGE_ME: das Root-Passwort der Datenbank und das Passwort des Benutzers Administrator.

  3. Starte alle Dienste und sieh dem Anlegen der Site zu:

    docker compose up -d
    docker compose logs -f create-site
    

    Der Dienst create-site legt beim ersten Start die Site erp.localhost an und installiert alle Apps in der Reihenfolge von apps.json. Das dauert einige Minuten, danach beendet sich der Dienst.

  4. Öffne und melde dich als Administrator mit dem Passwort aus Schritt 2 an.

  5. Der Einrichtungsassistent fragt zuerst nach Sprache, Land, Zeitzone und Währung. Wähle die Sprache Deutsch und das Land Deutschland. Der Assistent schlägt dann die Zeitzone Europe/Berlin und die Währung EUR vor und stellt Datum und Zahlen auf dd.mm.yyyy und #.###,##.

  6. Danach legt der Assistent dein Benutzerkonto und die Firma an. Als Kontenplan bietet ERPNext für Deutschland die Vorlagen „SKR03 mit Kontonummern“ und „SKR04 mit Kontonummern“ an. Welcher Kontenrahmen passt, klärst du mit deiner Steuerberatung.

Sprache und Land lassen sich später in den Systemeinstellungen ändern, die Sprache zusätzlich für jeden Benutzer. Was für den Dauerbetrieb dazukommt, also Reverse Proxy, Sicherungen und Updates, steht in Betrieb.

Versionen und Updates

Die Image-Tags entstehen aus Git-Tags der Form v-, etwa v16.60.0-1:

Image-Tag Zeigt auf
16.60.0-1 genau dieses Release
16.60.0 die neueste Revision zu ERPNext 16.60.0
16 das neueste Release mit ERPNext 16
latest das neueste Release, auch über eine neue Hauptversion hinweg
main, main- Builds des Branches main, kein Release
  • Pinne das volle Tag, etwa 16.60.0-1, oder den Digest. Bewegliche Tags wie 16 oder latest bringen beim nächsten Pull neue App-Versionen, ohne dass jemand bench migrate ausführt.
  • Ein Update ist ein Tag-Wechsel. Sicherung anlegen, neues Tag eintragen, Container neu erzeugen und bench --site migrate ausführen. Die Schritte stehen in Betrieb.
  • Die Revision zählt die Releases zu einer ERPNext-Version. Eine neue Revision bringt etwa neue Versionen der anderen Apps, ein neues Frappe oder ein neues Basis-Image. Die Release-Notes nennen alle Versionen.
  • Zurück geht es nur mit der Sicherung von vor dem Update, denn bench migrate ändert die Datenbank.

Schema, Release-Prozess und die Bedeutung der beweglichen Tags beschreibt Versionierung.

Eigenes Image

Wer andere Apps oder Versionen braucht, baut das Image selbst. Dafür braucht es Docker mit Buildx und Python 3.14.

  1. Repository forken und klonen.
  2. apps.json anpassen: Apps hinzufügen, entfernen oder andere Tags eintragen. python3 -m germanized validate prüft die Datei.
  3. Bauen und testen:

    ./build.sh                                     # builds erpnext_germanized:local
    ./tests/site/run.sh erpnext_germanized:local   # installs every app on a test site
    
  4. Nach docker login in die eigene Registry schieben:

    ./build.sh --tag registry.example.com/erp/erpnext_germanized:16.60.0-1 --push
    

Was beim Hinzufügen oder Entfernen einer App sonst zu tun ist, steht in Entwicklung.

Dokumentation

Mitwirken und Community

Beiträge sind willkommen

erpnext_germanized lebt davon, dass Menschen das Image in ihren Firmen, Branchen und Umgebungen betreiben und zurückmelden, was fehlt. Du kannst

  • Maintainer werden, für einen Bereich (etwa den Betrieb auf Kubernetes oder eine App) oder das ganze Projekt,
  • Apps vorschlagen, die deutsche Unternehmen brauchen,
  • den Betrieb testen, mit docker compose, Kubernetes oder deiner eigenen Umgebung,
  • Pull Requests für Fehlerbehebungen, Werkzeuge und Dokumentation stellen,
  • Dokumentation und Beispiele verbessern,
  • Fehler melden oder Funktionen vorschlagen.

Jeder Beitrag zählt. Du musst kein ERPNext-Profi sein, wir helfen beim Einstieg.

So geht es

  1. Repository forken und einen Branch anlegen
  2. Änderung samt Tests schreiben (Test zuerst, siehe Mitwirken)
  3. Lokal prüfen: pre-commit run --all-files und pytest, bei Änderungen am Image zusätzlich ./build.sh und ./tests/site/run.sh erpnext_germanized:local
  4. Pull Request mit kurzer Beschreibung und Quelle stellen, etwa den Release-Notes einer App
  5. Review gemeinsam durchgehen, bis es passt

Maintainer werden

Wer dauerhaft Verantwortung übernehmen möchte, zeigt das am einfachsten durch Pull Requests und Hilfe in Issues und Discussions und schreibt dann an oss@encircle360.com. Ein Bereich reicht, es muss nicht das ganze Projekt sein.

Support und professionelle Dienstleistungen

Community-Support

Professioneller Support

Für Einführung, Betrieb, Updates, Anpassungen oder Schulung rund um ERPNext und dieses Image: hello@encircle360.com

Related Localization apps for Frappe & ERPNext

  • Wiki — Free and Open Source Wiki built on top of Frappe
  • India Compliance — Simple, yet powerful compliance solutions for Indian businesses
  • Nepal Compliance — Open source ERP for Nepal with HR, Payroll & Accounting compliance, based on ERPNext by Frappe Technologies.
  • Kamra Pms — World's first open-source, agentic AI-ready PMS. Free hotel and short-term rental PMS (AGPL): front desk, folios, POS, housekeeping, booking engine, plus governed MCP so Claude can run the property. Built on Frappe v16.
  • Erpnextswiss — ERPNext application for Switzerland-specific use cases
  • Erpnext Germany — ERPNext customizations for German companies
  • Ksa Compliance — KSA Compliance App for KSA E-invoice
  • Zatca Erpgulf — Implementation of Zatca Phase-2 E-Invoicing - for FrappeCLoud