Installation
Zwei Wege funktionieren heute: das Docker-Image und die Installation aus dem Quellcode. Beide bringen eine eingebettete PostgreSQL-Datenbank und eine Demo-Firma mit.
Stand November 2026: Es gibt noch kein offizielles Release. Desktop-Installer (.exe, .dmg, .deb) und das PyPI-Paket sind vorbereitet, aber nicht veröffentlicht. Das Image mit dem Tag edge wird aus dem Hauptzweig gebaut.
Systemanforderungen
| Docker | Docker Engine mit Compose v2 (Linux) oder Docker Desktop (Windows, macOS). Image für amd64 und arm64 |
|---|---|
| Arbeitsspeicher | Mindestens 3 GB auf einem eigenen Server. Laut Projektdokumentation eine Untergrenze, keine Empfehlung |
| Aus dem Quellcode | Python 3.12 oder neuer, Node.js 22 oder neuer, Git |
| Datenbank | Eingebettetes PostgreSQL im Datenverzeichnis (Standard) oder eigener Server ab PostgreSQL 16 über DATABASE_URL |
| Port | 8080 (Docker), 8000 und 5173 (Entwicklung aus dem Quellcode) |
Welcher Weg wofür
| Docker | Ein Befehl, die Daten liegen im Volume. Zum Testen und für den Betrieb in einer kleinen Firma. |
|---|---|
| Docker Compose | Datenbank und Anwendung getrennt, für einen Server. |
| Quellcode | Zum Entwickeln oder wenn Sie kein Docker haben. |
1. Docker (Windows, macOS, Linux)
Ein Container mit Anwendung und Datenbank; alle Daten liegen im Volume obe-data. Unter Windows und macOS vorher Docker Desktop installieren.
$ docker run -d --name openbusinesserp --restart unless-stopped -p 8080:8080 -v obe-data:/data ghcr.io/datadrivenconstruction/openbusinesserp:edge Nach etwa einer Minute http://localhost:8080 öffnen. Den Fortschritt zeigt docker logs -f openbusinesserp.
2. Docker Compose mit eigenem PostgreSQL-Container
Für einen Server, auf dem Datenbank und Anwendung getrennt laufen sollen. Die Dateien stammen aus dem Repository; OE_IMAGE_TAG=edge ist nötig, weil es noch kein latest-Tag gibt.
$ mkdir openbusinesserp && cd openbusinesserp $ curl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenBusinessERP/main/docker-compose.quickstart.yml -o docker-compose.yml $ curl -fsSL https://raw.githubusercontent.com/datadrivenconstruction/OpenBusinessERP/main/docker-compose.quickstart.image.yml -o docker-compose.override.yml $ echo "POSTGRES_PASSWORD=$(openssl rand -base64 24)" > .env $ echo "JWT_SECRET=$(openssl rand -hex 32)" >> .env $ echo "OE_IMAGE_TAG=edge" >> .env $ docker compose pull app $ docker compose up -d
3. Aus dem Quellcode (Windows, macOS, Linux)
Für Entwicklung und zum Ausprobieren ohne Docker. Das Backend startet die eingebettete Datenbank selbst; das Frontend läuft als Entwicklungsserver.
$ git clone https://github.com/datadrivenconstruction/OpenBusinessERP.git $ cd OpenBusinessERP/backend $ python3 -m venv .venv $ source .venv/bin/activate $ pip install -e ".[server]" $ openbusinesserp serve --port 8000
> git clone https://github.com/datadrivenconstruction/OpenBusinessERP.git > cd OpenBusinessERP\backend > py -3.12 -m venv .venv > .venv\Scripts\Activate.ps1 > pip install -e ".[server]" > openbusinesserp serve --port 8000
$ cd OpenBusinessERP/frontend $ npm install $ npm run dev
Dann http://localhost:5173 öffnen.
Erste Anmeldung
Die Anmeldeseite bietet Demo-Konten an. Das Administratorkonto der Demo ist demo@openbusinesserp.com mit dem Passwort DemoPass1234!. Für Ihre eigene Firma führt der Einrichtungsassistent unter /setup durch Firmendaten, Steuer, Bank, Logo, E-Mail-Versand und die erste Rechnung.
Auf einem Server, der aus dem Internet erreichbar ist: Demo-Daten mit SEED_DEMO=false abschalten, ein eigenes Administratorkonto anlegen und HTTPS über einen Reverse Proxy davorsetzen.
Backup
Ein vollständiges Backup hat zwei Teile: die Datenbank und das Datenverzeichnis mit hochgeladenen Dateien, Logo und Einstellungen. Die Backup-Funktion in der Oberfläche exportiert nur die Datensätze eines Nutzers und ist kein Firmen-Backup.
$ docker stop openbusinesserp $ docker run --rm -v obe-data:/data -v "$PWD":/out alpine tar czf /out/obe-data-$(date +%F).tar.gz -C /data . $ docker start openbusinesserp
$ docker compose exec -T postgres pg_dump -U oe -Fc openestimate > backup-$(date +%F).dump # Volume-Namen mit docker volume ls prüfen (Projektname als Präfix) $ docker run --rm -v openbusinesserp_app_data:/data -v "$PWD":/out alpine tar czf /out/app-data-$(date +%F).tar.gz -C /data .
Aus dem Quellcode: Programm beenden, dann den Ordner .openestimate in Ihrem Benutzerverzeichnis (oder den Ordner aus OE_DATA_DIR) kopieren. Eine Kopie bei laufender Datenbank ist unbrauchbar.
Bewahren Sie Kopien auf einem anderen Gerät auf, und testen Sie eine Wiederherstellung, bevor Sie sie brauchen. Backup und Wiederherstellung im Handbuch.
Updates
Vorher ein Backup machen. Beim Start bringt die Anwendung das Datenbankschema selbst auf den neuen Stand.
$ docker pull ghcr.io/datadrivenconstruction/openbusinesserp:edge $ docker stop openbusinesserp && docker rm openbusinesserp $ docker run -d --name openbusinesserp --restart unless-stopped -p 8080:8080 -v obe-data:/data ghcr.io/datadrivenconstruction/openbusinesserp:edge
$ docker compose pull app $ docker compose up -d
$ git pull $ cd backend && pip install -e ".[server]" $ cd ../frontend && npm install