39 lines
1.3 KiB
Markdown
39 lines
1.3 KiB
Markdown
# 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. 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_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
|
|
{
|
|
"idempotencyKey": "notification-item-id:dev_...",
|
|
"devices": ["dev_..."],
|
|
"priority": "normal",
|
|
"ttlSeconds": 3600,
|
|
"collapseKey": "communication.message.new",
|
|
"notification": {
|
|
"title": "Neue FEDEO-Benachrichtigung",
|
|
"body": "Öffne FEDEO, um die Details anzusehen."
|
|
},
|
|
"data": {
|
|
"notificationId": "lokale-notification-id",
|
|
"link": "/communication"
|
|
}
|
|
}
|
|
```
|