Auto-héberger Rikoo

Rikoo tourne entièrement sur votre infrastructure. Les conversations, les documents, les secrets et les traces restent dans votre propre base de données et votre propre stockage objet, et les seuls appels sortants vont vers les fournisseurs de modèles et les outils que vous configurez.

Options de déploiement

Option	À utiliser pour	Guide
Docker Compose	Une évaluation, une démo ou une petite équipe sur une seule machine	Docker Compose
Kubernetes (Helm)	La production : réplicas, stockages managés, politiques réseau	Kubernetes (Helm)

Les deux voies font tourner les mêmes services. Infrastructure décrit chacun d'eux et ce que doivent fournir les stockages dont ils dépendent.

Accès au code source et aux images

Le dépôt source de Rikoo (Rikoo-app/rikoo) et les images de conteneur ne sont pas encore publics. Les deux guides ci-dessous nécessitent un accès accordé par l'équipe Rikoo : demandez-le via rikoo.io/contact. Le chart Helm (Rikoo-app/rikoo-k8s) est public.

Architecture

            browsers, websites, Slack, API clients
                          │
                          ▼
   ┌──────────────────────────────────────────────┐
   │ api   REST, Studio, widget, auth, enqueueing  │── PostgreSQL + pgvector
   └──────────────────────────────────────────────┘── Redis
                          │ queues (Redis)          ── S3-compatible storage
                          ▼
   ┌──────────────────────────────────────────────┐
   │ worker   runs, model calls, retrieval, tools  │──► model providers, MCP servers
   └──────────────────────────────────────────────┘    (through the egress guard)
         │ optional
         ├── sidecar-parsing   PDF and Office extraction
         └── mcp-sandbox       embedded tools, isolated workspace and browser

• L'api sert l'API REST, le Studio et le script du widget. En dehors de l'export de sa propre télémétrie, elle n'appelle jamais le monde extérieur : tout ce qui sort de la plateforme sort par le worker.
• Le worker exécute les agents : appels de modèles, recherche documentaire, appels d'outils, e-mails et webhooks. Chaque requête sortante passe par une garde anti-SSRF.
• Un service marqué optionnel qui manque dégrade une seule fonctionnalité, et rien d'autre n'échoue.

Éditions

Édition	Licence	Ce qu'elle ajoute
Community	GNU AGPL-3.0	Tout ce qu'il faut pour construire, publier et exploiter des agents, pour une organisation
Enterprise	Rikoo Enterprise License, avec une licence signée	SSO, validation humaine, contrôles de publication, audit complet, connecteurs de sources, plusieurs organisations, export des traces par organisation

L'édition Enterprise est un autre build des mêmes images, activé par une licence. Voir Licence Enterprise.

Après l'installation

• Placez l'api derrière un proxy inverse qui assure la terminaison TLS, et donnez à PUBLIC_URL l'adresse que saisissent les utilisateurs.
• Sauvegardez la base PostgreSQL, le stockage objet et la clé privée de scellement du coffre. Conservez cette clé ailleurs que dans la base qu'elle protège : sans elle, une sauvegarde restaurée ne peut lire aucun secret stocké.
• Branchez la plateforme sur votre supervision : les endpoints de santé, les métriques Prometheus et les traces OpenTelemetry sont listés dans Infrastructure.

Installation hors réseau

Rikoo fonctionne sans accès à internet. Le registre des prix et des capacités des modèles est livré avec le produit et n'est jamais téléchargé à l'exécution : le seul trafic sortant va vers les fournisseurs de modèles que vous configurez. Avec un serveur de modèles sur votre propre réseau, comme vLLM ou Ollama, il n'y en a aucun : autorisez sa plage d'adresses avec RIKOO_EGRESS_ALLOW_CIDRS, comme l'explique Infrastructure.

La construction des images depuis les sources télécharge des dépendances : construisez-les, ou récupérez-les, sur une machine qui a accès à internet, puis poussez-les vers un registre que vos serveurs atteignent.