OpenEOS selbst betreiben
OpenEOS lässt sich vollständig auf einem eigenen Server betreiben. Diese
Betriebsart heißt Einzelbetrieb (DEPLOYMENT_MODE=selfhosted) und ist
kostenlos und unbegrenzt: keine Freischaltung je Veranstaltung, keine
Obergrenze für Bestellungen, kein Stripe, keine Rechnungen.
Der Quelltext steht unter der AGPL-3.0 auf GitHub. Es gibt keinen Lizenzschlüssel, keine Telemetrie und keinen Rückkanal zu openeos.de — die Installation funktioniert dauerhaft ohne Internetverbindung nach außen.
:::info Wenn du OpenEOS veränderst
Die AGPL verlangt in § 13: Wer eine geänderte Fassung über ein Netzwerk
anbietet, muss allen Nutzer:innen den Quellcode dieser Fassung zugänglich
machen. Verwaltung, Kasse und Shop zeigen dafür einen Link „Quellcode
(AGPL-3.0)“. Setze in diesem Fall SOURCE_URL bei openeos-web und
openeos-shop auf dein eigenes Repository. Ohne Änderungen kannst du den
Standard (https://github.com/OpenEOS-Project) stehen lassen.
:::
Was du dafür brauchst
| Was | Anforderung |
|---|---|
| Server | Linux mit Docker und Docker Compose. 2 CPU-Kerne, 4 GB RAM und 20 GB Platte reichen für ein Vereinsfest. |
| Vorkenntnisse | Du solltest eine Textdatei bearbeiten und Befehle in einer Konsole ausführen können. |
| Netz | Die Kassen müssen den Server erreichen — im WLAN des Festplatzes oder über das Internet. |
| Optional. Ohne Mailserver funktioniert alles, siehe Benutzer anlegen. |
Was der Einzelbetrieb kann — und was nicht
Vollständig enthalten: Kassen, Bestellungen, Produkte und Kategorien, Standorte, Pfand, Rabatt-Bons, Inventur, Schichtpläne, Mitglieder mit Berechtigungen, Bondruck über ESC/POS-Drucker, Kunden- und Küchendisplays, Auswertungen und der Online-Shop.
Nicht enthalten, weil es zum gehosteten Angebot gehört:
- Abrechnung, Stripe, Rechnungen — es gibt schlicht nichts zu bezahlen
- Mehrere Organisationen nebeneinander (genau eine je Installation)
- Der Support-Chat zu uns
- Selbstregistrierung — Konten legt die Mitgliederverwaltung an
Diese Bereiche sind in der Oberfläche ausgeblendet; die zugehörigen
Schnittstellen antworten mit 404.
Die Bestandteile
| Dienst | Zweck | Pflicht |
|---|---|---|
openeos-api | Server: Schnittstelle, WebSocket, Datenbankzugriff | ja |
| PostgreSQL 16 | Datenbank | ja |
| Redis 7 | Sitzungen, Zwischenspeicher, WebSocket-Verteilung | ja |
openeos-web | Dashboard, Kassen-Oberfläche, Displays | ja |
openeos-shop | Öffentlicher Online-Shop je Veranstaltung | nein |
openeos-printer-agent | Drucker-Agent auf dem PC an den Bondruckern (Windows/Linux) | nur mit Bondruck |
Redis ist nicht optional: der Server startet ohne erreichbaren Redis nicht.
Der Weg durch diese Anleitung
- Installation — Server aufsetzen und starten
- Ersteinrichtung — Administrator und Organisation anlegen
- Benutzer anlegen — weitere Konten, mit und ohne Mailserver
- Drucker-Agent für die eigene Installation — Bondruck einrichten
- Betrieb — Sicherung, Aktualisierung, Fehlersuche
- Assistent einrichten — optional: Speisekarten-Import und Icon-Vorschläge mit eigenem Schlüssel
Unter app.openeos.de betreiben wir OpenEOS für dich — ohne Installation und mit Support. Die Abrechnung erfolgt dort je Veranstaltung. Das übrige Handbuch beschreibt diese Variante.