flfeders/FEDEO
2
1
Fork 0
Code Issues 106 Pull Requests Actions Packages Projects 22 Releases Wiki Activity

feat: zentrale selfhost-dienste bereitstellen

Browse Source
This commit is contained in:
Florian Federspiel
2026-08-02 16:34:10 +02:00
parent d3ad53bcf0
commit 8b8e0c97d3
30 changed files with 1818 additions and 74 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
push-server/docs/instance-client.md
View File

@@ -1,21 +1,22 @@
# Selfhost-Instanz anbinden
# Selfhost-Instanz an FEDEO Central Services anbinden
1. Instanz im Admin-Dashboard anlegen.
2. `instanceId` und den einmalig angezeigten `clientSecret` in der Selfhost-Instanz speichern.
3. Selfhost-Instanz sendet regelmäßig `POST /v1/instances/heartbeat`.
4. Geräte werden über `POST /v1/devices` registriert.
5. Push-Aufträge werden über `POST /v1/push` gesendet.
3. Im Instanzdetail die benötigten Dienste `ai` und/oder `banking` freischalten und Limits festlegen.
4. Selfhost-Instanz sendet regelmäßig `POST /v1/instances/heartbeat`.
5. Geräte werden über `POST /v1/devices` registriert; weitere Dienste liegen unter `/v1/services`.
## Umgebungsvariablen der Selfhost-Instanz
```env
FEDEO_PUSH_MODE=central
FEDEO_PUSH_GATEWAY_URL=https://push.fedeo.cloud
FEDEO_PUSH_INSTANCE_ID=inst_...
FEDEO_PUSH_CLIENT_SECRET=fps_...
FEDEO_PUSH_PAYLOAD_MODE=minimal
FEDEO_CENTRAL_SERVICES_ENABLED=true
PUSH_SERVER_URL=https://services.fedeo.de
PUSH_SERVER_INSTANCE_ID=inst_...
PUSH_SERVER_SECRET=fps_...
```
Wenn `FEDEO_CENTRAL_SERVICES_ENABLED=false` bleibt, verwendet FEDEO wie bisher direkt konfigurierte OpenAI- und GoCardless-Zugangsdaten. Damit bleibt ein vollständig unabhängiger Betrieb möglich.
## Minimaler Push-Auftrag
```json