ConfigsApr 1, 2026·1 min read

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.

TL;DR
Onyx provides self-hosted AI chat with RAG and 40+ connectors for enterprise search over your internal documents and tools.
§01

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.

§02

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.

§03

How to use

  1. Install Onyx: curl -fsSL https://onyx.app/install_onyx.sh | bash.
  2. Open http://localhost:3000 and configure your LLM provider (OpenAI, Anthropic, or local models).
  3. Connect knowledge sources through the admin panel and start asking questions.
§04

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
§05

Related on TokRepo

§06

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

What connectors does Onyx support?+

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.

Can I use local LLMs with Onyx?+

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.

How does Onyx handle document permissions?+

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.

Is Onyx free for commercial use?+

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.

How does Onyx compare to ChatGPT Enterprise?+

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
🙏

Source & Thanks

danswer-ai/danswer — 20,400+ GitHub stars

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets