Onyx — Self-Hosted AI Chat with 40+ Connectors
Onyx (formerly Danswer) is a self-hosted AI chat with RAG, custom agents, and 40+ knowledge connectors. 20.4K+ stars. Enterprise search. MIT.
Review-first install path
This asset needs a review step. The copied prompt tells the agent to dry-run, show the writes, then proceed only after confirmation.
npx -y tokrepo@latest install 210679a0-712f-4ec5-8d69-e0a016361c95 --target codexDry-run first, confirm the writes, then run this command.
What it is
Onyx (formerly Danswer) is a self-hosted AI chat platform that connects to your organization's internal knowledge. It supports 40+ connectors for tools like Slack, Confluence, Google Drive, Notion, GitHub, Jira, and more. Onyx uses retrieval-augmented generation (RAG) to ground AI answers in your actual documents, reducing hallucination.
Onyx is built for teams that need enterprise search and AI chat with full data control. If you want ChatGPT-like functionality over your internal documents without sending data to third-party services, Onyx keeps everything on your infrastructure.
How it saves time or tokens
Onyx replaces the pattern of manually searching across multiple tools (Slack, Confluence, Google Drive) to find information. You ask a question in natural language and Onyx retrieves relevant documents from all connected sources, then generates an answer with citations. The RAG pipeline ensures answers reference actual internal documents rather than general knowledge, reducing follow-up clarification. Custom agents let you create specialized assistants for different teams or workflows.
How to use
- Install Onyx:
curl -fsSL https://onyx.app/install_onyx.sh | bash. - Open
http://localhost:3000and configure your LLM provider (OpenAI, Anthropic, or local models). - Connect knowledge sources through the admin panel and start asking questions.
Example
# Quick install with Docker
curl -fsSL https://onyx.app/install_onyx.sh | bash
# Or manual Docker Compose setup
git clone https://github.com/onyx-dot-app/onyx.git
cd onyx/deployment/docker_compose
docker compose -f docker-compose.dev.yml up -d
# Access the UI at http://localhost:3000
# 1. Set up your LLM provider (API key)
# 2. Add connectors (Slack, Confluence, etc.)
# 3. Ask questions grounded in your documents
Related on TokRepo
- RAG tools -- retrieval-augmented generation tools and frameworks
- Self-hosted tools -- tools you can run on your own infrastructure
Common pitfalls
- Not configuring connector sync schedules. By default connectors may sync infrequently. Set appropriate intervals so the AI has access to recent documents.
- Using a weak LLM for complex queries. Onyx supports multiple LLM providers. For nuanced enterprise questions, use a capable model rather than a small local model.
- Ignoring access controls. Onyx supports document-level permissions from connected sources. Configure these to prevent users from seeing documents they should not have access to.
Frequently Asked Questions
Onyx supports 40+ connectors including Slack, Confluence, Google Drive, Notion, GitHub, Jira, Linear, Zendesk, Salesforce, PostgreSQL, S3, and more. Each connector syncs documents into the RAG pipeline for searchable, AI-grounded answers.
Yes. Onyx supports local LLMs through Ollama or any OpenAI-compatible API. This keeps all data and model inference on your infrastructure, which is important for organizations with strict data residency requirements.
Onyx respects permissions from connected sources. If a user cannot access a document in Google Drive, they cannot access it through Onyx either. This is configured per connector and uses the same authentication as the source system.
Yes. Onyx is MIT licensed and free for commercial use. There is no paid tier for the self-hosted version. The team offers paid cloud hosting and enterprise support separately.
Onyx is self-hosted, giving you full control over your data and LLM choice. ChatGPT Enterprise is a managed service from OpenAI. Onyx connects to 40+ tools for broader knowledge access, while ChatGPT Enterprise focuses on the OpenAI model ecosystem.
Citations (3)
- Onyx GitHub— Onyx (formerly Danswer) is a self-hosted AI chat with 40+ connectors
- Onyx Documentation— RAG pipeline grounds answers in internal documents
- Onyx License— MIT licensed and free for commercial use
Related on TokRepo
Source & Thanks
danswer-ai/danswer — 20,400+ GitHub stars
Discussion
Related Assets
Owncast — Self-Hosted Live Streaming Server
An open source, self-hosted, decentralized live video streaming and chat server that gives you full control over your broadcasts.
Tabby — Self-Hosted AI Coding Assistant
Self-hosted AI code completion and chat assistant. Privacy-first alternative to GitHub Copilot. Supports 20+ models, repo-aware context, and IDE integrations. 33K+ stars.
Whoogle — Self-Hosted Privacy-Respecting Search Engine
Whoogle is a self-hosted metasearch engine that proxies Google search results through your own server, stripping ads, tracking scripts, and AMP links while preserving result quality.
Tube Archivist — Self-Hosted YouTube Media Server
A self-hosted YouTube media server that downloads, indexes, and organizes YouTube videos. Tube Archivist provides a browsable archive with search, subscriptions, and playback.