This release includes 1 breaking change for platform teams planning a safe upgrade.
✓ No known CVEs patched in this version
Topics
+7 more
ReleasePort's take
Light signalRelease v4.0.2 lazy‑loads chat file bytes to prevent API server OOM and iteratively upserts hierarchy parents to avoid RecursionError.
Why it matters: Prevents out‑of‑memory crashes on the chat API server (severity 40) and stops RecursionError failures in deep hierarchies (severity 40).
Summary
AI summaryLazy‑load chat file bytes, fix a Docker nginx config typo, and iterate hierarchy upserts to avoid RecursionError.
Changes in this release
| Type | Severity | Summary | CVE |
|---|---|---|---|
| Breaking | High |
Requires running the OpenSearch document index migration before upgrading to v4.0. Requires running the OpenSearch document index migration before upgrading to v4.0. Source: llm_adapter@2026-05-28 Confidence: high |
— |
| Feature | Medium |
Add opt‑in structured JSON logging via LOG_FORMAT=json. Add opt‑in structured JSON logging via LOG_FORMAT=json. Source: llm_adapter@2026-05-28 Confidence: high |
— |
| Dependency | Low |
Downgrade transformers from version 5.5.4 to 4.57.6. Downgrade transformers from version 5.5.4 to 4.57.6. Source: llm_adapter@2026-05-28 Confidence: high |
— |
| Bugfix | Medium |
Lazy-load chat file bytes to prevent api-server OOM. Lazy-load chat file bytes to prevent api-server OOM. Source: llm_adapter@2026-05-28 Confidence: high |
— |
| Bugfix | Medium |
Iteratively upsert parents to avoid RecursionError on deep hierarchy chains. Iteratively upsert parents to avoid RecursionError on deep hierarchy chains. Source: llm_adapter@2026-05-28 Confidence: high |
— |
| Bugfix | Medium |
Fix Confluence permission sync draft 404 errors. Fix Confluence permission sync draft 404 errors. Source: llm_adapter@2026-05-28 Confidence: high |
— |
| Bugfix | Low |
Correct typo in nginx config name for no-letsencrypt compose file. Correct typo in nginx config name for no-letsencrypt compose file. Source: llm_adapter@2026-05-28 Confidence: high |
— |
Full changelog
Warning
Do not upgrade to this release if you want to preserve your existing indexed documents but have not yet run the document index migration, which can be done from any version v3.x. See additional documentation here.
See the assets to download this version and install.
What's Changed
- fix(chat): lazy-load chat file bytes to stop api-server OOM (#11439) to release v4.0 by @onyx-cherry-pick[bot] in https://github.com/onyx-dot-app/onyx/pull/11448
- fix(docker): typo in the nginx conf name in no-letsencrypt compose file (#11236) to release v4.0 by @jmelahman in https://github.com/onyx-dot-app/onyx/pull/11476
- fix(hierarchy): iterative upsert_parents to avoid RecursionError on deep chains (#11469) to release v4.0 by @onyx-cherry-pick[bot] in https://github.com/onyx-dot-app/onyx/pull/11477
- chore(deps): downgrade transformers from 5.5.4 to 4.57.6 (#11479) to release v4.0 by @jmelahman in https://github.com/onyx-dot-app/onyx/pull/11486
- fix: confluence perm sync draft 404s (#11468) to release v4.0 by @onyx-cherry-pick[bot] in https://github.com/onyx-dot-app/onyx/pull/11492
- ci: tag stable releases with major/minor/patch aliases (#11488) to release v4.0 by @jmelahman in https://github.com/onyx-dot-app/onyx/pull/11491
- feat(logging): opt-in structured JSON logs via LOG_FORMAT=json (#11490) to release v4.0 by @onyx-cherry-pick[bot] in https://github.com/onyx-dot-app/onyx/pull/11497
Full Changelog: https://github.com/onyx-dot-app/onyx/compare/v4.0.1...v4.0.2
Breaking Changes
- Document index migration required before upgrade; failure to run the migration will lose existing indexed documents.
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
About Onyx Community Edition
Chat UI that works with any LLM. It comes loaded with advanced features like agents, web search, RAG, MCP, deep research, Connectors to 40+ knowledge sources, and more.
Related context
Related tools
Beta — feedback welcome: [email protected]