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 | Debian bookworm, LibreOffice from the Debian archive; 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, O3O 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#
v1 involves three different document engines: the 26.04 engine in the editing server's DEV image, Debian bookworm's LibreOffice in DocBuilder, and the 26.8 engine of the O3O Office desktop apps. Complex documents may render slightly differently across the three. Cross-engine rendering comparison: not measured.
Coming soon
DocBuilder on the O3O 26.8 engine instead of Debian's LibreOffice; a source-built O3O editing server image.