Demo Stack
Der XOS Demo Stack ist eine vollständige Docker Compose Umgebung zum schnellen Einstieg und für Vorführungen.
Repository: github.com/xium-ai/demo
Voraussetzungen
- Docker mit Docker Compose v2
python3- XOS Binary — Download
Start
git clone https://github.com/xium-ai/demo.git
cd demo
make infra # Phase 1: Vault, Keycloak, PostgreSQL, etcd
# ~30s warten
make app # Phase 2: XOSP, MinIO, Memgraph, Setup-Job
make register # XOSP Fingerprint in etcd schreiben (einmalig)
./xos --etcd localhost:2379
Phasen
Der Stack ist in zwei Phasen aufgeteilt — analog zu realen Enterprise-Deployments, wo Vault und Keycloak immer vor den Anwendungen laufen.
Phase 1 — Infrastruktur (make infra)
Startet die Basisdienste: OpenBao (Vault), Keycloak, PostgreSQL, etcd. Diese Dienste müssen vollständig bereit sein bevor Phase 2 startet.
Phase 2 — Anwendung (make app)
Startet XOSP, MinIO, Memgraph, Redis, LiveKit und den Setup-Job. Der Setup-Job konfiguriert Vault, MinIO, Keycloak und schreibt alle Konfigurationskeys in etcd.
XOSP Fingerprint
Nach make app muss einmalig der XOSP Fingerprint registriert werden:
make register
Dieser Schritt liest den Fingerprint aus Vault und schreibt ihn in etcd. XOS nutzt ihn für Fingerprint-Pinning beim TLS-Connect zu XOSP. Nach einem make reset muss make register erneut ausgeführt werden.
Login
| Benutzer | Passwort | Rolle |
|---|---|---|
frank | xos-dev-2026 | xos-admin |
tristan | xos-dev-2026 | xos-user |
Endpunkte
| Service | URL |
|---|---|
| Keycloak Admin | http://keycloak.127.0.0.1.nip.io:8080/admin |
| OpenBao UI | http://openbao.127.0.0.1.nip.io:8200/ui |
| MinIO Console | http://localhost:9001 |
| Memgraph Lab | http://localhost:3000 |
| XOSP | https://localhost:9100 |
Stack-Komponenten
| Komponente | Port | Beschreibung |
|---|---|---|
| OpenBao | 8200 | Secrets, PKI, XOSP Identity |
| Keycloak | 8080 | IAM / OIDC |
| PostgreSQL | 5432 | Relationale Datenbank |
| etcd | 2379 | Konfigurationsquelle |
| MinIO | 9000 / 9001 | HTML-Templates (S3) |
| Memgraph | 7687 | Graph-Datenbank für Contexts |
| Redis | 6379 | Cache |
| LiveKit | 7880 | Voice / Video |
| XOSP | 9100 | Plugin-Server |
Makefile-Referenz
| Befehl | Beschreibung |
|---|---|
make infra | Phase 1 starten |
make app | Phase 2 starten |
make register | XOSP Fingerprint registrieren (einmalig) |
make upload | HTML-Templates nach MinIO hochladen |
make seed-ctx | Context-Gruppen in Memgraph laden |
make install-ca | OpenBao CA im Mac Keychain installieren (sudo) |
make status | Laufende Container |
make down | Stack stoppen |
make reset | Stack + Volumes löschen |
Reset
make reset # Löscht alle Container und Volumes
make infra
make app
make register