Platform
Licensing and editions
How the community and enterprise editions differ, loading the license token, offline operation, token states and pricing.
On this page
Self-hosted MORA Office Online comes in two editions on the same installation: a free community edition and an enterprise edition. Upgrading needs no reinstall: just load a license token. Enterprise pricing follows the MORA price list (see Pricing).
How the editions differ#
| Item | Community | Enterprise |
|---|---|---|
| Price | Free | Per MORA Self-host (priced per user) or an integration quotation, see Pricing below |
| License token | no | yes |
| Concurrent editing connections | 50 | Exactly conns from the token, even when below 50; orders are at least 50 |
| Editor embedding and save callbacks | yes | yes |
| DocBuilder endpoints | 10 endpoints, no template filling | All 11 endpoints (token with api_full) |
| DocBuilder rate | 10/minute, 200/day | 60–3,000/minute by connection count, no daily limit |
| Maximum DocBuilder file size | 10 MB | 300 MB |
| Job completion callbacks | no | yes (token with callback) |
| White label | no | Coming soon, source-built MORA image only |
| Soft overage | no | Coming soon |
Every limit in detail: Plan limits. How connections are counted: How connections are counted.
Loading the license token#
The gate and DocBuilder read the token in this order: the O3O_LICENSE_TOKEN variable when not empty, then the O3O_LICENSE_FILE file (default /etc/o3o/license.token) when it exists, otherwise no token (community edition). Leading and trailing whitespace is trimmed. The file is re-read every 60 seconds, so replacing it needs no restart; changing the environment variable requires recreating the container.
Put the token in place
Either paste it intoO3O_LICENSE_TOKENinonline/.env, or save it as a file mounted into botho3o-gateando3o-docbuilderat/etc/o3o/license.token.Load it
With the environment variable:docker compose ... up -d. With the file: wait up to 60 seconds.Check
GET /o3o/statusmust showlicense.state = "valid",edition = "enterprise"andconnections.limitequal to the purchased connections;GET /v1/limitsmust showedition = "enterprise".
# Option 1: environment variable in online/.env (token shortened for readability)
O3O_LICENSE_TOKEN=eyJ2IjoxLCJrZXkiOiJPT1NZLTdLMk05LVE0WEJDLUQ4SEpOLVIzVFdaIiwicGxhbiI6InllYXIiLCJwcm9kIjoibzNvLW9ubGluZSIs...base64...==.W2m7...base64...==
# Option 2: a file; leave O3O_LICENSE_TOKEN empty
O3O_LICENSE_TOKEN=
O3O_LICENSE_FILE=/etc/o3o/license.token
# Check after loading
curl -s http://localhost:8080/o3o/status | jq '{edition, license: .license.state, limit: .connections.limit}'
curl -s http://localhost:8080/v1/limits -H "Authorization: Bearer O3O_DEMO_KEY" | jq .edition# docker/compose.license.yml, use with: -f docker/compose.dev.yml -f docker/compose.license.yml
# ./license.token is relative to the first compose file's folder (online/docker/)
services:
o3o-gate:
volumes:
- ./license.token:/etc/o3o/license.token:ro
o3o-docbuilder:
volumes:
- ./license.token:/etc/o3o/license.token:roToken format#
A token is base64(payload_json) + "." + base64(signature): standard Base64 with = padding (alphabet +/), exactly one dot, and an Ed25519 signature over the exact payload bytes. The gate and DocBuilder verify it with the MORA license server's public key (O3O_LICENSE_PUBKEY). Unknown payload fields are ignored.
{
"v": 1,
"key": "OOSY-7K2M9-Q4XBC-D8HJN-R3TWZ",
"plan": "year",
"prod": "o3o-online",
"mid": "",
"cust": "Công ty TNHH An Phát",
"exp": "2027-09-30",
"upd": "2027-10-07",
"iat": 1790000000,
"lid": 123,
"kind": "enterprise",
"conns": 200,
"feat": [
"api_full",
"callback"
]
}Payload fields
vnumberrequiredFormat version:1or2.prodstringrequiredMust beo3o-online.kindstringrequiredenterpriseorcommunity; onlyenterpriseupgrades the edition.connsintegerrequiredPurchased connections, 1 or more. With a valid enterprise token the connection cap is exactly this number, even when it is below the community edition's 50.planstringrequiredyear(annual) orlife(perpetual).expstringoptionalYYYY-MM-DD, required foryear; valid until the END of that day, UTC+7.updstringoptionalYYYY-MM-DD: end of update rights. Images built after this date reject the token. For annual plans the license server setsupd = exp + 7 days(the grace period, matching the gate).featarrayoptionalDefault:[]Features:whitelabel,api_full(full DocBuilder),callback(DocBuilder callbacks).midstringoptionalBound instance id; empty, absent or*means unbound.keystringrequiredLicense code, shapedOOSY-XXXXX-XXXXX-XXXXX-XXXXX(annual) orOOSL-…(perpetual). The gate does not check the code's shape;/o3o/statusonly shows the last 5 characters (key_hint).custstringoptionalCustomer name.iatnumberrequiredSigning time, Unix seconds.lidnumberoptionalLicense server internal id; ignored by the gate and DocBuilder.aidnumberoptionalInternal activation id, present only when the token belongs to an activation; ignored by the gate and DocBuilder.
Token states#
license.state | Meaning | Effective edition |
|---|---|---|
none | No token. | community |
valid | Valid signature, not expired. | enterprise (when kind = enterprise) |
grace | Annual plan up to 7 days past exp; grace_days_left is the days remaining. | enterprise |
expired | More than 7 days past exp. | community |
invalid | Broken format, bad signature, bad mandatory fields, or a TEST key outside DEV mode. | community |
wrong_product | prod is not o3o-online. | community |
update_expired | The image was built after upd. | community |
instance_mismatch | The token is bound to another instance (mid). | community |
Working offline#
- The token is verified entirely OFFLINE with the Ed25519 public key in the configuration; your MORA server does not call office.o3o.vn and sends usage data nowhere.
- A server on an isolated network gets the full enterprise edition until
exp, plus 7 days of grace for annual plans. - Perpetual licenses never expire; update rights end at
upd: images built before that date keep accepting the token forever. - To bind a token to exactly one server, request a token whose
midequals theinstance_idfrom/o3o/status. When you use an instance-bound token, setO3O_GATE_INSTANCE_IDexplicitly in.envso the gate and DocBuilder share the same id;scripts/gen-secrets.sh(orgen-secrets.ps1) generates it when it creates a new.env.
Online activation with a license code, heartbeat and revocation through the office.o3o.vn server. v1 only verifies offline.
Renewing and raising limits#
MORA signs and delivers a new token once the order is complete. Replace the token the same way you loaded it; the gate picks it up within 60 seconds (file) or after the container is recreated (environment variable). Open sessions are not affected.
Pricing#
From 15 November 2026, MORA Office Online is no longer sold per connection. Self-hosted installations receive an enterprise token under MORA Self-host: VND 49,000 per user per month, minimum 50 users, billed every 12 months; deployment, API integration and dedicated support are quoted separately. Hosted MORA Office Online is included in the MORA Personal and Business plans.