Reference
Compatibility matrix Beta
Which versions of the gate, DocBuilder, editing server, Nextcloud and Docker go together in v1, and the constraints that must match.
This page describes a beta feature: it works but may still change.
v1 matrix#
| Component | Version | Notes |
|---|---|---|
| API contract | v1 | DocBuilder /v1/*, gate /o3o/*, O3O.Editor. |
| o3o-gate | 1.0.0 | Python 3.12 on python:3.12-slim-bookworm; also serves api.js. |
| o3o-docbuilder | 1.0.0 | The document engine; the actual version is in the core field of GET /v1/status. |
| o3oscript | 1 | Schema o3oscript-v1.schema.json. |
| o3o-online, DEV image | 26.04.4.1.1 | Pinned sha256:1efda304…bf97. INTERNAL TESTING ONLY. |
| o3o-online, MORA image | not available | Coming soon, see Building from source. |
| o3o-proxy | nginx 1.27 (alpine) | |
| Nextcloud | 30 (nextcloud:30-apache) | Connected through the richdocuments app and the WOPI protocol; nextcloud profile. |
| MariaDB, Redis | 11, 7 | Only for the nextcloud profile. |
| Docker | Docker Desktop 29, Linux engine; Compose v2 | The verified environment. |
| License token | v 1 and 2 | Ed25519, verified offline. |
Constraints within one deployment#
| Pair | Constraint |
|---|---|
| o3o-gate ↔ o3o-docbuilder | Same API v1, same plans.json (copied into the image at build time), same license token. |
| o3o-gate ↔ o3o-online | O3O_ONLINE_ALIASGROUP1 equals O3O_GATE_INTERNAL_URL; same admin account. The way the gate reads session figures is verified with image 26.04.4.1.1; other images: not tested. |
| o3o-online ↔ Nextcloud | O3O_ONLINE_ALIASGROUP2 contains Nextcloud's WOPISrc origin; richdocuments' wopi_url points at the editing server. |
api.js ↔ o3o-gate | api.js is served by the gate itself, so the versions always match; do not keep your own copy of api.js. |
| Token ↔ image | The image build date (O3O_BUILD_DATE) must not be later than the token's upd. |
Document engines#
In v1 the editing server, DocBuilder and the MORA Office desktop apps may run different engine versions, so complex documents may render slightly differently across the three. Cross-engine rendering comparison: not measured.
Coming soon
DocBuilder and the editing server on the same MORA Office engine.