selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Onyx Community Edition logo

Self-host Onyx Community Edition

helm/onyx-0.9.45

Open-source AI enterprise search and chat over your apps

BetaOpen CoreMIT
irm https://onyx.app/install_onyx.ps1 | iex
Updated2 days ago
LanguagePython
Setup difficultyModerate
Stars
33 412
CPU
4 vCPU minimum (Standard mode; Lite 2 vCPU)
RAM
10 GB minimum (Standard mode; Lite 2 GB)
Storage
32 GB + ~2.5x indexed data (Standard; Lite 10 GB)
Port
3000 (HTTP entry point of the Docker Compose deployment (access Onyx at localhost:3000))
Requires
PostgreSQL

What is Onyx Community Edition?

Onyx is an open-source AI platform that acts as a knowledge and context layer for a team: it connects to more than 50 applications, ingests documents along with their metadata and permissions, and serves that context to humans and AI agents. Core capabilities are agentic RAG search over a hybrid index, an LLM chat UI, custom agents with actions, deep research reports, live web search, a sandboxed Python code interpreter, image generation and artifacts, plus voice mode. It works with all major LLM providers, self-hosted (Ollama, LiteLLM, vLLM) or proprietary (Anthropic, OpenAI, Gemini), and exposes itself through a web UI, a desktop app, Slack and Discord bots, an MCP server, a Chrome extension and an embeddable website widget. Self-hosting is done with the guided onyx-cli installer or the Docker Compose files under deployment/docker_compose, with Kubernetes, Helm, Terraform and AWS/GCP/Azure/DigitalOcean guides; an air-gapped offline install is supported. Two modes exist: Standard (indexing, workers, model servers, Redis and object store) and Lite, a lightweight chat deployment under 1 GB memory that cannot index documents. The Community Edition is MIT licensed; enterprise extras such as OIDC/SAML SSO, RBAC, white-labelling and data exports sit in separately licensed ee directories and paid plans.

Should you self-host Onyx Community Edition?

Onyx Community Edition scores 79/100 on selfhost.directory (how scoring works) and ranks #5 of 41 in Search Engines. It has 33 412 GitHub stars, +986 in the last 30 days.

It shipped 145 stable releases in the past year. The latest, helm/onyx-0.9.45, came out on 14 November 2026. New versions land roughly every 1 days.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is pipeshub (66/100, 4 124 stars). Onyx Community Edition scores higher overall. See Onyx Community Edition vs pipeshub side by side.

Features

  • AI chat interface
  • Air-gapped deployment
  • Custom AI agents
  • Deep research reports
  • Desktop App
  • Enterprise search / RAG over connected appsIndexing requires Standard mode; Lite does not index documents.
  • Image Generation
  • MCP support (server and client actions)
  • Query history and usage analytics
  • REST API
  • Role-based Access ControlRBAC appears in the Business tier of the pricing page.
  • Sandboxed code execution
  • Single sign-on (OIDC / SAML)Listed under the paid Enterprise plan on the pricing page.
  • Voice Mode
  • Web SearchMust be configured by an admin.

Onyx Community Edition README

Discord Documentation Website License

onyx-dot-app/onyx | Trendshift

Onyx - The context layer powered by all your apps

How to install Onyx Community Edition

Install Onyx Community Edition with Docker Compose

Environment variables
IMAGE_TAG
git clone --depth 1 https://github.com/onyx-dot-app/onyx.git
cd onyx/deployment/docker_compose
docker compose up -d

Alternatively, to build images from source:

docker compose up -d --build --force-recreate

Requires Git and Docker with compose; Onyx is then reachable at localhost:3000.

How to configure Onyx Community Edition

  • IMAGE_TAGLine in the deployment .env that pins the Onyx image version (rewritten by onyx-cli deploy upgrade).
  • --liteDeploy Onyx Lite (no OpenSearch, Redis, or model servers)
  • --include-craftEnable Onyx Craft — Craft is opt-in via this flag only and is not offered by the interactive prompt
  • --tagImage tag to deploy (default: the latest Onyx release)
  • --dirDeployment directory (default: `~/.config/onyx`, or an existing `./onyx_data`)

Onyx Community Edition releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

Why is Onyx refusing to search the internet?

Web Search has to be enabled by an admin with a supported search provider; a scraper is optional since one is built in.

Does Onyx keep its knowledge up to date?

Connectors refresh on a schedule, typically every 30 minutes, with documents, metadata and permissions all updated.

Why can't Onyx find information that I know exists?

Indexing may not have finished, access controls may be wrong (the system defaults to least permissive), or a connector is misconfigured.

Responses are really slow, is this expected?

No; slow responses usually come from a slow or non-streaming LLM, or locally configured reranking/embedding models without a GPU.

Why is my Onyx deployment not coming up?

Under-resourcing the deployment is the most common cause; the docs advise checking the Resourcing page requirements.

Can I run Onyx offline?

Yes, the whole system can be air-gapped, but you must run a local LLM, and a recent non-quantized model is recommended.

How do I know if Onyx is right for me?

It targets teams of any size, from enterprises needing unified search to a single user wanting a local chat UI, emphasising privacy and grounded answers.

How is my private data being processed?

The docs point to the Security section, stating Onyx is built with security and data privacy as a core commitment.

What kind of questions can I ask Onyx?

Questions about knowledge from connected applications, general world knowledge the LLM already has, and anything searchable on the web when Web Search is configured.

More in Search Engines

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…