🛠️ Infrastruktur

Setup- und Infrastrukturübersicht

Your Office AI lässt sich selbst hosten. Dieser Abschnitt ist die Betreiber-Checkliste aller externen Dienste, die zum Betrieb der Plattform einzurichten sind – wofür jeder da ist, ob er erforderlich ist und wo seine Konfiguration liegt. Arbeiten Sie die Liste in der Startreihenfolge durch, damit jede Abhängigkeit erfüllt ist, bevor die nächste sie benötigt.

ℹ️
Wo die Konfiguration liegt

Almost all server secrets live in the tenant server's config files plus a gitignored command_center_tenant_server/config/passwords.yaml. The Auth server has its own command_center_server/config/passwords.yaml for the auth database and email. Non-secret host/port settings live in the matching config/development.yaml / staging.yaml / production.yaml. Never commit passwords.yaml.

Startreihenfolge

Jeder Dienst hängt von den vorherigen ab. Richten Sie sie von links nach rechts ein: zuerst Datenspeicher, dann Echtzeit und KI, dann die optionalen Integrations- und E-Mail-Ebenen.

🗄️DatenbankenAuth + Tenant-Postgres
RedisPub/sub + Skalierung
📦ObjektspeicherMinIO / Supabase
📡LiveKitVideo + Sprachtransport
🧠LLM + EmbeddingsAnbieter + pgvector
🔌IntegrationenNango + E-Mail
Zuerst Datenspeicher, dann Echtzeit und KI, dann Integrationen und E-Mail.

Die Dienst-Checkliste

Every external service an operator touches, with the page that documents it in detail. Required services are needed for the core product to run; per-feature services unlock a specific capability; optional ones are recommended but not load-bearing.

DienstWofür er da istBedarfKonfiguriert in
PostgreSQL (Supabase or managed)Zwei Datenbanken: eine für den Auth-Server, eine pro Tenant für den Tenant-Server.Erforderlichconfig + passwords.yaml
RedisPub/sub für Echtzeit-Streams; obligatorisch, sobald mehr als eine Tenant-Server-Replika betrieben wird.Erforderlichconfig + passwords.yaml
Object storage (Supabase Storage / MinIO)Datei-Uploads, Wissensdokumente und Avatare. S3-kompatibel – MinIO für selbst gehostete, Supabase Storage für verwaltete Deployments.ErforderlichFlutter-App + Bucket-Richtlinien für den Speicher
LiveKitEchtzeit-Video, -Audio, Bildschirmfreigabe und der Transport des Sprachassistenten.Erforderlichpasswords.yaml des Tenant-Servers oder Admin-Oberfläche
LLM + embedding provider keysSechs LLM-Anbieter plus ein Embedding-Modell für die semantische Suche im Wissen (pgvector).Erforderlichpasswords.yaml des Tenant-Servers
Voice providers (Deepgram / Google Cloud)STT + TTS für die einheitliche Sprach-Bridge. Anbieterunabhängig – Sie wählen, welchen Sie konfigurieren.FunktionsspezifischOrg-Einstellungen → Sprache & KI + Agent-Umgebung
OAuth / integrations (Nango)OAuth-Verbindungsvermittler für den Integrationskatalog (Google, Slack, Microsoft, …).FunktionsspezifischNango-Instanz + passwords.yaml des Tenant-Servers
Transactional email (Resend)Versendet Registrierungsbestätigungen, Passwortzurücksetzungen und Organisations-Einladungen per E-Mail.Erforderlichpasswords.yaml des Auth-Servers
Observability (OpenTelemetry + ClickHouse)Logs, Traces und Metriken der App und beider Server, abfragbar zur Fehlersuche.Optionalconfig/development.yaml → otel + Docker
Multi-instance scalingBetreibt mehrere Tenant-Server-Replikas hinter einem Load Balancer mit gemeinsam genutztem Redis.OptionalLoad Balancer + Redis + Umgebung

Detailanleitungen

Wie die Teile zusammenpassen

Your Office AI runs a dual-server backend: an Auth server for identity and organisations, and a Tenant server per organisation for chat, knowledge, integrations, and LiveKit tokens. Each connects to its own Postgres database. AI agents and workflows execute on a Python LangGraph engine behind a Dart AI server, and AI answers are grounded in your Knowledge through pgvector semantic search.

KomponenteKommuniziert mit
Auth-ServerAuth Postgres, Resend (email)
Tenant-ServerTenant Postgres, Redis, LiveKit, LLM/embedding providers, Nango, object storage, OTel collector
LangGraph-KI-EngineTenant server (callbacks), LLM providers
Sprach-Bridge-WorkerLiveKit, tenant server, STT/TTS providers
💡
Schlank starten, schrittweise erweitern

Nur PostgreSQL, Redis, Objektspeicher, LiveKit, ein LLM-Anbieter, ein Embedding-Modell und E-Mail werden benötigt, um das Produkt zu betreiben. Sprachanbieter, Integrationen über Nango und der Observability-Stack werden ergänzt, wenn Sie diese Funktionen aktivieren.

Einmal konfiguriert, dauerhaft gesteuert

Once an admin configures a provider, its spend is governed centrally: every numeric cap in Your Office AI has a hard positive minimum, and a value of 0 disables the feature rather than removing the limit. There is no such thing as an unlimited budget.

6
LLM-Anbieter, eine Organisation
4
Freigabeebenen × Ansicht / Bearbeitung
0 unlimited budgets
0 bedeutet deaktiviert, niemals unbegrenzt

ℹ️
Weiter

Head to Kerndienste & Umgebung to set up the databases, Redis, object storage, and provider keys that everything else depends on.