v2.0.0
v2.0.0 has breaking changes.
You may want to test the upgrade in a staging environment before deploying to production.
Key Improvements
UI Refresh
Onyx has a brand new UI with updated colors, components, and subtle changes to the layout. Check out this release video showcasing the new UI!Single-sign on (SSO) added to Community Edition
SSO (via OIDC and SAML) is now available in the Community Edition of Onyx!All users can now configure basic authentication, Google OAuth, or SSO via identity providers like Okta and Azure EntraID.Read more about authentication options in our deployment docs. Read more about our open source philosphy in our Open Source Statement.Projects
Projects allow users to organize files and chats based on a specific context. You can think of this as a folder where you upload files, define project-level instructions, and work from the same starting point in every chat session.
New Docker Compose File
We’ve simplified the Docker Compose files to make it easier to deploy Onyx.Previously, you may have useddocker-compose.dev.yml, docker-compose.prod.yml, or docker-compose.gpu-dev.yml.
These have been consolidated into a single docker-compose.yml file.With the new compose file, you can run docker compose up -d to start Onyx.If you’ve previously used the old compose files, you will need to add the
-p onyx-stack flag.I.e. docker compose -p onyx-stack up -d.Additionally, you will need to migrate any changes you may have made to your compose file.Organization info and personalization
We’ve found that questions posed to Onyx often require context on who you are, what you work on, and what your company does. It is difficult to infer this from search results alone because they are a narrow view into your context.To help with this, admins can now add information about their organization in the Workspace Settings tab of the Admin Panel. Additionally, users can add information about themselves in the User Settings page.
Curators can now create actions
Due to popular demand, Curators and Global Curators can now create Actions via OpenAPI or MCP!Read more about Actions in our admin docs.
Search filters
Source filters are back for the Internal Search Action!To filter the sources of your search results, click the Actions configuration button in the Input Bar, select the arrow next to Internal Search, and select the sources you want to include.
Language and Embedding Models
We’ve added support for Claude Sonnet 4.5, Claude Haiku 4.5, and Gemini Embedding 001.Try them out by configuring Anthropic in the LLM Configuration page and Google Vertex AI on the Search Settings page of the Admin Panel.Contributor Highlights
- @Django149 added right-to-left language support for the chat interface!
- @nsklei added support for indexing Microsoft Teams attachments!
- @linkages added generation of SHA256 hashes of documents for the Onyx File Store!
- @grafke fixed a bug in GPT search timestamps!
Additional Improvements
Support for SSE (server-sent events) MCP servers
Onyx now supports SSE (server-sent events) MCP servers. Configure either Streamable HTTP or SSE servers in the Admin Actions page.Read more about MCP in our admin docs.Ollama Support
You can now configure both locally-hosted and cloud-hosted models with Ollama. Read more about Ollama in our admin docs.One Line Deployment Script
We’ve added a single line launch script to make it easier to deploy Onyx. This script will check your system resources and requirements and guide you through the necessary steps to deploy Onyx.This script is intended for new users. For existing users,
we recommend sticking with your existing deployment method.
KEDA Autoscaling
We’ve added support for KEDA (Kubernetes Event-Driven Autoscaling) to Onyx Helm charts. Kubernetes deployments may choose either HPA (Horizontal Pod Autoscaling) or KEDA for autoscaling.Our GitHub Releases page has the full list of changes and bugfixes for each release.
Release Notes Prior to v2.0.0
Check out our GitHub Releases page for details regarding prior changes.Additionally, our Discord#announcements channel is a great place to stay up to date with Onyx updates.Major releases and breaking changes are also announced in the Discord Server.