Page informative, sans valeur de conseil. Installez depuis la source officielle, vérifiez la licence du logiciel et des modèles, et gardez en tête qu'un modèle de langage peut se tromper ou mal citer : vérifiez les sources qu'il indique.
À quoi ça sert
Onyx est un moteur de recherche IA d'entreprise (Gen-AI + Enterprise Search). Il indexe les sources de connaissance d'une équipe — wikis, bases documentaires, canaux Slack, fichiers partagés — et permet à chacun de poser une question en langage naturel. La réponse s'appuie sur les documents internes et cite ses sources, pour qu'on puisse remonter à l'original.
Sa différence avec les solutions SaaS du marché : Onyx se déploie sur vos serveurs. Avec un modèle local ou un hébergement de confiance, vos données ne quittent pas votre périmètre.
Ce qui fait sa force
- Plus de 50 connecteurs. Confluence, Notion, Google Drive, Slack, GitHub, Jira, SharePoint, dossiers locaux… Onyx va chercher la connaissance là où elle vit déjà et la réindexe régulièrement, sans recopie manuelle.
- Des réponses traçables. Chaque réponse pointe vers les documents utilisés. Dans un contexte d'équipe, cette traçabilité est ce qui distingue un assistant utile d'une boîte noire.
- Auto-hébergeable et agnostique du modèle. Onyx tourne sur votre infrastructure et se branche sur le LLM de votre choix, y compris Ollama en local. Vous gardez la main sur l'endroit où vivent données et traitements.
- Gestion fine des accès. Comptes, rôles, et — selon l'édition — respect des permissions des sources connectées : un utilisateur ne voit dans les réponses que ce à quoi il a droit côté source.
- Un projet mûr. Anciennement Danswer, Onyx est l'un des assistants de recherche open source les plus aboutis pour l'entreprise, avec une communauté active.
Pour qui
Pour les équipes et petites structures qui veulent une base de connaissance interrogeable sans envoyer leurs données chez un tiers. Niveau requis : avancé à expert — le déploiement Docker est conséquent (plusieurs services, base vectorielle) et la configuration des connecteurs demande un investissement initial. Pour un usage individuel ou une petite documentation, AnythingLLM ou Khoj sont plus simples à mettre en place.
Installation
Prérequis
Docker et Docker Compose. Un serveur Linux (ou Windows avec WSL2) avec au moins 8 Go de RAM est recommandé : Onyx lance plusieurs services, dont une base vectorielle qui réclame de la mémoire.
Déploiement avec Docker Compose
# Cloner le dépôt officiel
git clone https://github.com/onyx-dot-app/onyx.git
cd onyx/deployment/docker_compose
# Copier et adapter la configuration
cp .env.prod.example .env.prod
# Éditer .env.prod : mots de passe, domaine, fournisseur LLM
# Lancer les services
docker compose -f docker-compose.prod.yml up -d
L'interface est ensuite accessible sur http://localhost:3000 (ou votre domaine
configuré).
Connecter un modèle local
Dans les réglages administrateur, choisissez Ollama comme fournisseur LLM et renseignez l'adresse de votre instance. Consultez la fiche Ollama pour installer le moteur.
Ajouter des sources (connecteurs)
Depuis l'interface admin, activez les connecteurs correspondant à vos outils. Chaque connecteur indexe régulièrement les nouvelles données et alimente la base vectorielle interrogée à chaque question.
Le point licence : deux éditions, deux régimes
C'est le point à comprendre avant tout déploiement, et il est précis :
- Onyx Community Edition (CE) — licence MIT. Elle couvre les fonctionnalités cœur (chat, RAG, agents, actions). Permissive : usage interne et commercial sans contrainte de copyleft.
-
Onyx Enterprise Edition (EE) — Onyx Enterprise License. Tout le code situé sous les
répertoires
ee/du dépôt (notammentbackend/eeetweb/src/app/ee) n'est pas sous MIT mais sous une licence propriétaire, l'Onyx Enterprise License (une copie figure dans chaque répertoireee/). Elle encadre des fonctions surtout utiles aux grandes organisations.
Autrement dit : le dépôt est public, mais il n'est pas intégralement MIT. Avant un usage commercial, identifiez les fonctionnalités que vous activez et le répertoire dont elles relèvent.
Points de vigilance
| Point d'attention | Niveau | Ce qu'il faut savoir |
|---|---|---|
| Édition utilisée et licence associée | 🔴 à clarifier avant déploiement | Le code ee/ est sous Onyx Enterprise License (propriétaire), pas sous MIT. Vérifiez quelles fonctions vous activez : seule la Community Edition (MIT) est librement utilisable sans condition particulière. |
| Connecteurs vers des services cloud | 🟡 selon les sources | Brancher Google Drive, Slack ou Notion implique ces services dans la chaîne : Onyx en récupère le contenu pour l'indexer. Pour une confidentialité maximale, limitez-vous aux sources locales et au modèle local. |
| Sauvegarde de l'index vectoriel | 🟡 à anticiper | L'index alimente toutes les réponses. Sa reconstruction sur un large corpus peut prendre des heures. Sauvegardez la base et l'index — une perte n'expose pas de données, mais coûte cher en temps de réindexation. |
| Exposition de l'interface | 🟡 selon déploiement | Le port 3000 donne accès à toute la connaissance indexée. Ne l'exposez pas en direct : reverse-proxy HTTPS, authentification activée dès le premier lancement, accès restreint. |
Sécurité
- Activez l'authentification dès le départ. Onyx propose plusieurs modes (email/mot de passe, SSO/SAML selon l'édition). Ne laissez jamais l'instance ouverte.
- Placez l'accès derrière HTTPS via un reverse-proxy (Nginx, Caddy) — le port 3000 ne doit pas être exposé directement.
- Modèle et sources locaux pour le sensible. LLM via Ollama, connecteurs limités aux sources internes : rien ne sort du périmètre.
- Sauvegardez base et index vectoriel régulièrement, et suivez les annonces de sécurité sur le dépôt officiel.
Aller plus loin
- Ollama — le moteur local à connecter à Onyx.
- AnythingLLM — alternative plus simple pour un usage individuel.
- Khoj — assistant personnel avec recherche dans vos notes et le web.
- Docling — préparer vos PDF avant indexation.
- OSIALab — vue d'ensemble de tous les outils.
Sources
- Site officiel : onyx.app
- Code source & licences (MIT pour la Community Edition ; Onyx Enterprise License pour les répertoires
ee/) : github.com/onyx-dot-app/onyx - Documentation : docs.onyx.app