Onyx Community Edition
Onyx is an open-source, self-hosted AI search and knowledge platform that indexes your applications and company data so teams and AI agents can find accurate,…
Platform availability
Available on 1 of 10 platforms
- Unraid (not listed)
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
79/100 Good
- Maintained
- 100last commit 2 days ago
- Popular
- 9033,465 GitHub stars
- Easy to install
- 251 install platform, install notes
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today
- GitHub stars
- 33,465
- Open issues
- 703
- Last commit
- 2026-11-19
- Latest release
- v5.1.3
- Activity
- rising
Checked 3 days ago - source: GitHub (onyx-dot-app/onyx)
Resources & Compatibility
Requirements not published yet.
Checked 3 days ago - source: Docker Hub image tags and published docs
First-install notes
- Use the guided installer first Copy the quickstart command exactly: uv tool install onyx-cli && onyx-cli deploy install. It checks your machine, installs Docker on Linux if needed, writes settings to ~/.config/onyx, pulls containers, and waits for services to be healthy so you do not get a half-running setup. source
- Back up the settings folder The guided installer stores your Onyx settings in ~/.config/onyx. Back up that folder before major changes or reinstalling, because losing it can force you to redo the first-time setup. source
- If using Craft, install with the flag Run the Craft quickstart installer with --include-craft instead of just adding ENABLE_CRAFT=true to .env. It also mounts the Docker socket, the connection used to start sandbox containers, so Craft sandboxes do not fail. source
- Install Onyx You can deploy a self-hosted instance with a single command from the README: curl -fsSL https://onyx.app/install_onyx.sh | bash source
Fetched 3 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Which folder should I back up before reinstalling Onyx or making major changes?
Back up the ~/.config/onyx settings folder, because losing it can force you to redo first-time setup.
What should self-hosters check when migrating an existing Onyx deployment after the permissions update?
Review the permissions migration details, because Onyx now uses group-based permissions.
Can self-hosted Onyx run in an air-gapped environment?
Yes, it provides an air-gappable self-hosted deployment where the document index, database, and processing happen within a self-contained set of services.
Answers sourced from docs.onyx.app, github.com, github.com
Community
Collected 3 days ago - public community threads