Onyx Community Edition vs Enterprise Edition

Onyx Community Edition is MIT licensed and covers chat, RAG, agents and connectors. This page explains which controls need the Enterprise license, what each edition costs to run, and when the paid edition is worth it.

On this page

When the free Onyx edition is enough and when Enterprise is needed

If you want a self-hosted assistant over company documents, the MIT-licensed Onyx Community Edition covers chat, RAG, agents and connectors. The identity, provisioning, role and audit features, including OIDC and SAML SSO, SCIM, role-based access control, usage analytics and query history auditing, sit under the Onyx Enterprise License in directories marked ee. Decide which of those controls your policy requires before you read any further, because that decision, not the feature list, settles the edition.

The Community Edition wins when your access model is simple and your identity controls can be met outside the assistant. If a small team can sign in through an existing mechanism, your review of who can see what can happen at the source applications, and you do not need an auditable record of individual queries, the free edition keeps license cost at zero. Onyx's connectors still sync source permissions, so answers draw only on documents a user can already see in the source application (Onyx README). Confirm with your security team whether that sync satisfies your document-level access review, and confirm which sign-in method the Community Edition supports in your deployment version.

Enterprise becomes necessary when a policy names a control the Community Edition does not provide: centrally managed sign-in through OIDC or SAML, automated joiner and leaver provisioning through SCIM, or query auditing that an assessor can sample. Onyx's pricing page lists a Business plan at $20 per user per month billed annually, while Enterprise is priced on request and includes OIDC and SAML SSO, on-premise and region-specific deployments (Onyx pricing page). Ask for a written quote that names the license scope, the deployment model, the number of users and what support is included, and ask whether the Enterprise license covers your self-hosted installation, since the page does not say so explicitly.

Which Onyx capabilities are in the free edition and which need Enterprise

This table maps Onyx capabilities to the MIT-licensed Community Edition and the Enterprise Edition license, using the Onyx README, LICENSE file and pricing page. Where the sources list a feature as enterprise without naming the exact code boundary, the cell tells you to confirm it. The main takeaway: identity, governance and audit features are the usual reasons to buy Enterprise, so check each one against the current pricing page and the ee directories before you plan around the free edition.

CapabilityCommunity Edition (MIT)Enterprise Edition
RAG and AI chatCovered under the MIT license per the README and LICENSEIncluded, but confirm whether any RAG code sits in ee directories
Agents and actionsCovered under the MIT license per the README and LICENSEIncluded, but confirm any agent features in ee directories
Connectors with permission syncConnector code is in the open repository; confirm which sources sync permissionsREADME says answers respect synced permissions; confirm the edition boundary
Self-hosted models (Ollama, LiteLLM, vLLM)Listed as supported in the README; confirm no edition gateSame model support listed; confirm against the pricing page
Google OAuth, OIDC and SAML SSONot listed as a Community feature; confirm with OnyxREADME lists it as enterprise; pricing page lists OIDC and SAML under Enterprise
SCIM user provisioningListed as an enterprise feature; confirm with OnyxListed as an enterprise feature in the README
Role-based access control (RBAC)Listed as an enterprise feature; confirm with OnyxListed as a premium feature in the deployment docs
Usage analytics and query history auditingListed as an enterprise feature; confirm with OnyxListed as an enterprise feature in the README
On-premise and region-specific deploymentsSelf-hosted open source deployment is available; confirm the scope of supportListed on the pricing page under Enterprise, which includes everything in Business

How licensing, support and updates differ between the two editions

Onyx splits its code across two licenses, and the paid plan adds terms that sit outside the code itself. The four cards below separate what the MIT license covers, what the Enterprise License governs, what the Enterprise plan bundles, and what a managed Onyx Cloud contract would change, so you can ask the right questions before you commit.

MIT license for Community Edition

The Community Edition code outside the ee directories is MIT licensed, so your team can run, modify and redistribute it inside your own infrastructure without a license fee. The license covers code, not support: it does not promise fixes, patch timing or an upgrade path. Check the LICENSE file in the repository for the exact terms you rely on, and confirm with Onyx which release line receives security fixes.

Enterprise License for ee directories

Code in the ee directories falls under the Onyx Enterprise License, not MIT, so copying those files into a product you ship or redistribute carries separate obligations. Ask legal to read the license against your planned use before your engineers build on any ee module. Also confirm whether a self-hosted Enterprise deployment needs a license key or activation step and what happens to running features if the license lapses.

Enterprise plan includes Business

Onyx's pricing page places OIDC and SAML SSO, on-premise deployments and region-specific deployments under Enterprise, which includes everything in Business. The Business plan is listed at $20 per user per month billed annually, with Enterprise priced on request. Treat the Business figure as a reference point only: a quote for self-hosting depends on your user count, deployment scope and support terms, and you should request those in writing.

Managed Onyx Cloud contract

Onyx Cloud is a managed service, so the vendor operates the infrastructure, and the terms of service and data processing agreement govern hosting, data location and availability. Self-hosted Enterprise keeps the workload in your cloud account or data center, but puts patching and upgrades on your team or your implementation partner. Ask Onyx for its uptime commitments, incident notice and data deletion terms in writing before you compare the two options on cost.

Which Onyx setup fits each team profile

A small team that mainly needs chat over a shared set of documents often starts with the MIT-licensed Onyx Community Edition. The Community Edition covers RAG, AI chat, agents and actions, so the core question is whether the team can run the infrastructure and accept the open-source feature set. For a light footprint, Onyx Lite removes the vector database and background workers, which suits a smaller document set. Onyx Standard adds vector and keyword indexing and background sync, which matters once connectors keep many sources current.

  • Edition: Community Edition, since SSO, SCIM, RBAC and query auditing sit in the Enterprise Edition license.
  • Deployment shape: Docker Compose for a single host is the simplest path to a pilot, with Kubernetes or Helm when the team already operates a cluster.
  • Lite or Standard: Lite for chat and agents without connector-driven indexing, Standard when permission-synced connectors are central.
  • Model choice: Hosted providers such as OpenAI or Anthropic, or self-hosted models through Ollama, LiteLLM or vLLM if data may not leave your network.
  • Operating load: One team member usually owns upgrades, backups and connector credentials, so confirm that capacity before choosing Standard.

Confirm which connectors you need, whether they honor source permissions for your tenant, and who will maintain the Postgres, Redis and index services after go-live.

What the Onyx paid edition costs and what drives the price

How much does the Onyx Business plan cost per user?

Onyx's pricing page lists the Business plan at $20 per user per month billed annually. That is the only published per-seat figure for the paid tier, and it covers the Onyx cloud plan rather than a self-hosted Enterprise Edition license. Confirm with Onyx which deployment model a Business subscription applies to before you budget for it, because the self-hosted path is priced differently. Check the current figure on the Onyx pricing page before you finalize any budget, since list prices can change.

Why is Onyx Enterprise priced on request?

Onyx does not publish a price for Enterprise, and the pricing page lists it as on request. The Enterprise tier adds OIDC and SAML SSO, on-premise deployments and region-specific deployments on top of everything in Business. Those features depend on your user count, deployment footprint and support needs, so the price follows from the scope you define. Ask Onyx to state the price basis (per user, per deployment or a flat fee) in writing so you can compare it with your own estimate.

What should a written Onyx quote include?

A usable quote states the license tier, the number of seats and the billing term, and it names every feature the tier includes. It should also list the deployment model (self-hosted, Onyx Cloud or self-hosted Enterprise), the support terms, and any renewal or price-change conditions. For a self-hosted build, ask who pays for the Postgres, Vespa or OpenSearch index, Redis and model server infrastructure, because the license does not cover it. Request a separate line for implementation work, if any, so one-time and recurring costs stay visible.

Which Onyx infrastructure costs are one-time and which recur?

Most infrastructure cost is recurring, because the services run continuously. The Onyx deployment docs list Postgres, Vespa or OpenSearch for the index, Redis and model servers as part of the Standard deployment, along with background sync workers and object storage. Setup, initial sizing and the first configuration are one-time efforts, while compute, storage, backups and model inference recur. Model inference costs grow with usage if you call a proprietary provider, and they stay near fixed if you run local models through Ollama or vLLM on your own hardware. Ask your infrastructure team to model both the initial build and the monthly run cost.

What drives the infrastructure cost of a self-hosted Onyx deployment up or down?

The main drivers are the size of the document corpus, the number of connectors syncing and how often they sync, the number of concurrent users, and where the models run. A larger index needs more storage and memory for the search backend, while more frequent sync jobs add background worker load. Choosing Onyx Lite instead of Standard removes the vector database and background workers, which lowers the footprint for chat and agents without document indexing. Local model servers shift cost to hardware you already own or must buy, while proprietary providers shift it to per-use billing. Ask for the sizing assumptions behind any quote so you can test them.

How much effort does it take to integrate Onyx SSO and SCIM with our identity provider?

The effort depends on your identity provider, your protocol choice and how much provisioning you need. Onyx lists Google OAuth, OIDC or SAML for single sign-on, and SCIM user provisioning, role-based access control and query history auditing among its enterprise features, so those are the items to scope. Expect work in configuring the application in your IdP, mapping groups to Onyx roles, testing logout and session behavior, and validating that deprovisioning removes access. Ask Onyx and your implementation partner to name a duration only after they review your IdP setup, because no published timeline is available for this step.

Can our own team run the Onyx Enterprise setup, or do we need outside help?

Your team can run it if it already operates Kubernetes or Docker, a PostgreSQL service and an identity provider, and has time to own upgrades. The open-source Community Edition is MIT licensed, so the code is free to run, but Enterprise features such as SSO, SCIM and RBAC are under the Onyx Enterprise License and require that license. Outside help is useful when the scope covers multiple connectors, air-gapped hosting or formal evidence for an assessment. Whichever path you choose, define the scope in writing first so the work and its cost are clear.

Moving from Community to Enterprise without rebuilding the deployment

The sequence keeps your existing Onyx deployment in place while you add the Enterprise Edition features your environment needs, so identity, access and audit controls are proven in a test environment before any user is moved.

  1. Confirm which enterprise features you need

    Start by listing the Enterprise Edition features your environment depends on, such as OIDC or SAML SSO, SCIM user provisioning, role-based access control, usage analytics and query history auditing. Your security and identity teams should own this list, and your current Community deployment should be inventoried first so you know which connectors, models and index services it already runs. The step is done when the list is written down and each item is tied to a stated control requirement. Confirm with Onyx which items fall under the Enterprise Edition license before you request it.

  2. Obtain the Enterprise license and written scope

    Request an Enterprise Edition license from Onyx. Pricing is set on request for Enterprise, so ask for a written quote that names the features, deployment model and support terms included. If you want DeployOpen to handle configuration and testing, agree a written scope with DeployOpen that lists the deliverables, environments and timelines before any work starts. The step is done when the license terms and the signed scope are both on file and the owners of each are named.

  3. Enable SSO and SCIM in a test environment

    Build a copy of the current deployment in a non-production environment and apply the Enterprise license there. Configure OIDC or SAML against your identity provider and turn on SCIM provisioning so user and group changes flow from the directory. Your identity team should test sign-in for each user population, including users who sign in through a different path today. The step is done when test users sign in through the new flow, provisioned and deprovisioned accounts behave as expected, and the configuration is recorded in version control.

  4. Validate RBAC roles and permission sync

    Map your directory groups to Onyx roles and test each role with accounts that represent real job functions. Confirm that a user only sees answers drawn from documents they can already access in the source application, since Onyx syncs source permissions through its connectors. Check the boundary cases, such as users who change groups and connectors that have restricted spaces. The step is done when every role has a test sign-off from its business owner and any gaps are either fixed or accepted in writing.

  5. Check usage analytics and query auditing output

    Run a set of known test queries as different roles, then confirm that usage analytics and query history record them with the expected user, time and context. Export the audit output to the format your security operations or compliance team uses, and confirm that retention and access to the logs match your policy. Ask Onyx to confirm the retention settings and export options for your edition, since these details are not part of the researched facts. The step is done when the audit trail reproduces the test queries accurately and the compliance owner accepts the output as evidence.

  6. Verify data continuity and rollback before cutover

    Before any production change, take a backup of the database, index and object storage, and confirm that the upgraded configuration reads the existing indexes, connectors and chat history without a rebuild. Rehearse the rollback path in the test environment, including restoring the Community configuration and confirming that the index still matches the source applications. Your platform team should record the recovery steps and who authorizes them. The step is done when a restore has been rehearsed successfully and the rollback runbook has been reviewed.

  7. Cut over users in controlled groups

    Move users to the enterprise sign-in in stages, starting with a pilot group of named users and widening only after their issues are closed. Keep the rollback runbook active during each stage and monitor sign-in failures, provisioning errors and audit gaps. Communicate the change to users and give them a contact for access problems. The step is done when all user populations are on the enterprise sign-in, the pilot and wider groups have confirmed access, and the handover documentation is filed with your operations team.

What the free edition is missing for typical enterprise controls

Identity federation and deprovisioning are where the Community Edition boundary matters most to security teams. The Onyx README lists OIDC and SAML SSO, SCIM user provisioning and role-based access control among enterprise features, so these sit under the Enterprise Edition license rather than the MIT-licensed Community Edition. Without federation, user accounts are typically created and removed inside Onyx itself, which means the identity provider is no longer the single place where joiners, movers and leavers are decided. A review should check how a departing employee's access would be removed in each case, and how long that removal takes to be reflected in the application. Confirm with Onyx which of these controls the Enterprise Edition license includes in your deployment before you design the process around them.

Role separation and query auditing are what turn a working system into evidence. Role-based access control lets administrators, operators and end users hold different rights, and usage analytics and query history auditing record who asked what and when. An auditor reviewing access to documents indexed from SharePoint or Confluence will expect to see who could change connector settings, who could read query history and whether those rights were approved. If the Community Edition lacks these records, the team may need to build its own logging around the platform, and that work should be scoped and owned before an assessment begins. Ask Onyx to document exactly what the audit trail records and how long it is retained.

A small team with one administrator and low data sensitivity may not need any of this. If a handful of people use an internal assistant over non-sensitive content, local accounts and manual offboarding can be a reasonable, documented risk decision, and paying for the Enterprise Edition would add cost without a matching control gain. The decision changes when the platform indexes regulated data, when several teams need different document access, or when an external assessor will ask for evidence of access reviews. Write down the data classes in scope, the number of administrators and the review cadence, then compare them against the Enterprise Edition scope in a written quote. This page does not establish that any control satisfies a specific compliance requirement.

Common questions before choosing an Onyx edition

Can the Onyx Community Edition run in production?

Yes, the Community Edition can serve production traffic because its code is MIT licensed and covers RAG, AI chat, agents and actions, and the connector set in the repository. The license does not settle readiness, though. Production fitness depends on how you size and monitor the Standard deployment (Postgres, Vespa or OpenSearch, Redis, model servers and object storage), how you apply upgrades, and whether you need features gated behind the Enterprise license, such as OIDC or SAML SSO, SCIM provisioning, RBAC, usage analytics and query history auditing. Confirm with Onyx which support terms, if any, apply to Community deployments before you commit to a production date.

How long does an Onyx Enterprise rollout take?

The length of an Enterprise rollout depends on drivers you can list before work starts, and no fixed duration applies to every team. The main drivers are the number of connected sources and how each one's permissions sync, the identity provider setup for OIDC or SAML and SCIM, the deployment target (cloud, on-premise or region-specific, all listed under Enterprise), and whether models run locally through Ollama or vLLM or through a hosted provider. Internal approvals also matter: security review, data classification and change windows. Ask for a fixed-scope plan that lists milestones, deliverables and the inputs your team must supply on each date.

Can our team run Onyx without outside help?

A platform team can run Onyx alone if it already operates Kubernetes or Docker, manages PostgreSQL and search clusters, and has time to handle upgrades and monitoring. The Community Edition is open source, so you can start without a license purchase. Recurring work includes tracking releases, such as Onyx v4.9.2 published on October 15, 2026, and the Helm chart, version 0.9.17 as of October 16, 2026, testing each upgrade against your connectors, and restoring from backups. Outside help can cover a one-time implementation, hardening and documentation under a fixed scope, or an ongoing retainer for upgrades and support. Decide early which of these tasks your staff will own after handover.

What does an Onyx deployment need from identity and infrastructure teams?

Your identity team registers Onyx as an application with your identity provider, configures OIDC or SAML, maps groups to roles for RBAC, and sets up SCIM provisioning if you need automated user lifecycle changes. Connector setup needs service accounts or app registrations for each source, such as SharePoint, Google Drive or Confluence, and permission sync only works if those accounts can read the permissions the source application holds. Your infrastructure team provides compute, storage, DNS, certificates, backups and network paths to each model provider, or confirms that all models run locally for an air-gapped setup. Document these owners in the scope before work begins.

Does the Enterprise license change the data Onyx stores?

The license terms and the stored data are separate questions, and the supplied facts do not say that Enterprise code stores different data categories. The Enterprise feature list includes usage analytics and query history auditing, so query records and usage data are kept in some form when those features are on. Confirm what is logged, where it is stored, how long it is retained, who can read it, whether user identifiers or document content appear in logs, and whether everything stays inside your environment. Ask the same questions about SCIM, which handles user provisioning data. Code in the ee directories falls under the Onyx Enterprise License, so check that terms with Onyx as well.

What should a fixed-scope quote for Onyx include?

A fixed-scope quote should separate one-time work from recurring costs and name who is paid for each. The cost components are the implementation fee for planning, integration, hardening and documentation, the Onyx license tier you choose, your own cloud or hardware, and any model API usage charged by hosted providers. DeployOpen does not publish a price list, so the quote follows from the written scope. Ask for the named connectors, identity integrations, deployment target, acceptance criteria, exclusions, the Onyx license tier and who buys it, and the terms of any retainer for upgrades and support. Compare quotes on the same list of deliverables.

How much does Onyx Business cost compared with Enterprise?

Onyx's pricing page lists the Business plan at $20 per user per month billed annually, and it lists Enterprise as priced on request. The page places OIDC and SAML SSO, on-premise deployments and region-specific deployments under Enterprise, which includes everything in Business. Confirm whether Business applies to a self-hosted Community deployment at all, and whether it includes SCIM, RBAC, usage analytics or query auditing, since those features are not itemized in the supplied pricing details. Ask Onyx for a written Enterprise quote that states the per-user basis, the billing period, the minimum seat count and the renewal terms. The published Onyx pricing page is the natural starting point for that conversation.

How DeployOpen scopes and delivers either Onyx edition

DeployOpen plans, implements, integrates, hardens, documents and supports self-hosted open-source platforms inside your own cloud accounts, data centers or air-gapped networks. For Onyx, that means deciding which edition your identity, audit and access requirements actually need, then delivering that edition inside your environment with the evidence your reviewers will ask for.

How we scope

  • Engagements are fixed-scope, with the edition, connectors, models and deployment target agreed in writing before work starts.
  • We map which requirements need the Enterprise Edition license, such as OIDC or SAML SSO, SCIM, RBAC and query auditing, and which the MIT-licensed Community Edition covers.
  • Scope names the Onyx deployment path, including whether Onyx Standard or Onyx Lite fits the workload and the data sensitivity involved.

How we build

  • We deploy Onyx with Docker, Kubernetes, Helm or Terraform inside your infrastructure, following the components named in the written scope.
  • We configure connectors and confirm that source-application permissions sync so answers only draw on documents each user can already see.
  • We connect self-hosted models through Ollama, LiteLLM or vLLM, or proprietary providers, as the agreed scope specifies.

How we hand over

  • Handover includes configuration, deployment and architecture documentation for the chosen edition and its services.
  • We document which features run under the Community Edition and which depend on an Enterprise Edition license, so your team can verify entitlements.
  • Runbooks cover upgrades, backups and access administration, with the control evidence your compliance reviewers requested in scope.

How we support

  • Ongoing support, upgrades and continuous testing are available as a retainer after handover.
  • Upgrades are planned against the Onyx release and Helm chart versions you approve, with changes tested before rollout.
  • DeployOpen prepares systems and evidence for compliance assessments, while independent auditors issue any audit report or certification.

Talk to our team.

Tell us what you're working on, whether it's a deployment, an audit, a security test or a cyber range. You'll speak with an engineer who can help you scope it.

  • 30-minute call: free, with no obligation.
  • NDA on request: we can sign before you share details.
  • Clear next steps: a scope and plan after the call.