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.
- Author: encircle360-oss
- Repository: https://github.com/encircle360-oss/erpnext_germanized
- GitHub stars: 6
- Forks: 0
- License: Apache-2.0
- Category: Localization
- Maintenance: Actively Maintained
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:
[](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.jsonist die einzige Liste der Apps. Das Tag von Frappe steht als Vorgabe vonFRAPPE_BRANCHimContainerfile. - 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 verifyprüft. - Nur
linux/amd64. Ein Image fürlinux/arm64gibt 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.
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.yamlErsetze in
compose.yamlunterx-sitebeideCHANGE_ME: das Root-Passwort der Datenbank und das Passwort des Benutzers Administrator.Starte alle Dienste und sieh dem Anlegen der Site zu:
docker compose up -d docker compose logs -f create-siteDer Dienst
create-sitelegt beim ersten Start die Siteerp.localhostan und installiert alle Apps in der Reihenfolge vonapps.json. Das dauert einige Minuten, danach beendet sich der Dienst.Öffne und melde dich als
Administratormit dem Passwort aus Schritt 2 an.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.yyyyund#.###,##.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 wie16oderlatestbringen beim nächsten Pull neue App-Versionen, ohne dass jemandbench migrateausführt. - Ein Update ist ein Tag-Wechsel. Sicherung anlegen, neues Tag eintragen, Container neu erzeugen und
bench --site migrateausfü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.
- Repository forken und klonen.
apps.jsonanpassen: Apps hinzufügen, entfernen oder andere Tags eintragen.python3 -m germanized validateprüft die Datei.Bauen und testen:
./build.sh # builds erpnext_germanized:local ./tests/site/run.sh erpnext_germanized:local # installs every app on a test siteNach
docker loginin 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
- Architektur: Stufen des Containerfile,
apps.jsonals Build-Secret, Inhalt des Images, Herkunft der deutschen Teile - Betrieb: docker compose, Kubernetes, Volumes, Sicherungen, Updates, Scheduler und Worker, Reverse Proxy
- Versionierung: Tags, Revisionen, Release-Prozess, Pinnen
- Apps: jede App mit Zweck, Lizenz, deutschen Besonderheiten und Einrichtung
- Entwicklung: Aufbau, Werkzeuge, Tests, CI, lokaler Build, Apps hinzufügen und entfernen
- Roadmap: Stand und nächste Schritte
- Changelog, Mitwirken, Hinweise für Coding-Agenten, Sicherheit
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
- Repository forken und einen Branch anlegen
- Änderung samt Tests schreiben (Test zuerst, siehe Mitwirken)
- Lokal prüfen:
pre-commit run --all-filesundpytest, bei Änderungen am Image zusätzlich./build.shund./tests/site/run.sh erpnext_germanized:local - Pull Request mit kurzer Beschreibung und Quelle stellen, etwa den Release-Notes einer App
- 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
- Matrix: #oss:encircle360.com für den direkten Austausch mit Maintainern und Nutzern
- Issues: Fehler und Wünsche zu erpnext_germanized
- Discussions: Fragen und Austausch
- Fehler in Frappe, ERPNext oder einer der Apps bitte beim jeweiligen Projekt melden: frappe/frappe, frappe/erpnext, frappe/hrms, alyf-de/erpnext_germany, alyf-de/erpnext_datev, alyf-de/eu_einvoice, alyf-de/erpnext_pdf-on-submit, alyf-de/banking, encircle360-oss/steuerbote. Fehler im Image, im Beispiel und in den Werkzeugen gehören in die Issues dieses Repositories.
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