Repository navigation
EN Clever RPO And RTO
Français · Type: explanation · Audience: admin · Context: hosted Studio · Status: ready · Applies from: 4.2.3
The Studio Server (hosted team Studio) · contract: experimental · verified by CI (support matrix of 4.4.0, 2026-10-23): Postgres, S3 and Keycloak in CI; Chromium and Firefox (job studio-hosted); WebKit on macOS, by hand only · automated checks: jobs
studio-hosted,studio-install-smoke; CI planstudioHosted; 3 test files · people's passes:studio-hostednot run (#149),studio-collabnot run (#150),studio-previewnot run (#166),studio-assets-hostednot run (#167),studio-mcp-remotenot run (#196),studio-oidc-genericnot run (#197) · known limits:bucket-loss,rto-not-measured
Two numbers say what a hosted Studio can lose and how long it can be down: the RPO (recovery point objective, the changes a recovery may lose) and the RTO (recovery time objective, how long the recovery takes). This page defines both for the Studio Server, says how each is measured on your installation, and ties them to the measures of the reference deployment. They are observations, never promises.
A team writes the game together, all day. If the database is lost, the question is not whether a backup exists but which changes come back, and when people can write again. The Studio Server answers with two mechanisms, each tied to one number:
- The journal shipped to the bucket bounds the RPO. Each confirmed operation is copied to Cellar as an immutable segment, in order, as soon as it is written (a failure is retried within 30 s).
- The daily backup plus the replay bounds the RTO. A restore writes the latest backup into a new database, then replays every segment shipped since (restore drill).
What a restore can lose is the operations confirmed but not yet shipped to the bucket when the database was lost. At any moment that is the age of the oldest operation not shipped yet:
-
GET /readyzgives it asrpoMs(0 when everything is shipped); - with metrics on,
studio_journal_rpo_secondssays the same (Monitoring).
The target is one minute (D42): watched, with an alert past 60 s for 5 min, never promised.
Measure ·
rpo-observedRPO observed: 0. Two notes written after the backup (revisions 64 and 65) were both replayed by the restore;rpoMswent back to 0 within 2 s of each write.
- date: 2026-10-19
- version: 4.2.2
- volume: a backup at revision 63, 2 operations written after it, head 65
- conditions: reference deployment phase B, engine at commit c66fbf56 before the 4.2.3 tag (package.json said 4.2.2); one member writing; Clever Cloud test organisation, region par; PostgreSQL DEV, Cellar S
- source: QUALIF-4.2.3-REFERENCE.md §3 and §4
Limit ·
bucket-lossThe RPO above holds for the loss of the database. If the bucket is lost too, the blobs, the journal and the backups go with it: what you can recover is your last copy of the bucket made elsewhere (Backups, step 4), and the RPO is the age of that copy.
The time from the decision to restore to the moment the Studio serves writes again (/readyz 200 on the
restored database). It adds up:
- creating a new PostgreSQL add-on (not measured);
- downloading the latest backup (not measured);
- the restore with its replay;
- pointing the studio app at the new add-on (
clever service link-addon, unlinking the lost one) and redeploying (a studio deploy took 29 s to 1 min 29 s in the reference deployment, migrations included); - the new instance taking the service lease.
Only step 3 is measured:
Measure ·
restore-stepThe restore step, from the maintainer's machine: 28.7 s (a backup at revision 1, 508 rows, nothing to replay), then 59.7 s (a backup at revision 63, 593 rows, 2 operations replayed). The report does not say what the difference comes from.
- date: 2026-10-19
- version: 4.2.2
- volume: 508 rows; then 593 rows and 2 operations replayed
- conditions: Clever Cloud test organisation, region par; PostgreSQL plan DEV, Cellar plan S; run from a machine in Paris,
tsxstart-up included; engine at commits 52e68932 then c66fbf56 before the 4.2.3 tag (package.json said 4.2.2); one sample each- source: QUALIF-4.2.3-REFERENCE.md §4
Limit ·
rto-not-measuredNo full RTO was measured: the drills restored into a side database and never switched production over to it. Time your own drill end to end, with your game's size, and write it in your records: that is your RTO, as of that day.
-
A redeploy refuses writes for a while (503 with
Retry-After) and loses none: a write retried with its operation id is applied once (Redeploys). - A restore logs everyone out (sessions are not in a backup), and drafts still in a member's browser were never confirmed: they are not part of the RPO, and the Studio keeps a refused draft in the editor.
- PostgreSQL's own backups only. They would restore the tables, not tie them to the file contents in Cellar at the same instant. The Studio's backup lists the blobs it names and refuses to restore when one is missing.
- A continuous replica. Not offered: one instance, one database, and the journal shipped to the bucket instead.
- The journal and the backups share the bucket with the contents: one place to lose. Copy it elsewhere.
- The RPO depends on Cellar being reachable: while it is not,
rpoMsgrows (Worker, PostgreSQL or Cellar down). - Measures come from one small game and one member writing, on the test organisation: not a production load.
- D42 (the one-minute RPO target, a full backup daily):
docs/dev/DECISIONS.md. -
ADR 0025, the Studio Server; the measures:
docs/dev/QUALIF-4.2.3-REFERENCE.md. - The procedures: Backups, Restore drill.
Generated publication · publication générée — current documentation · documentation courante: quest'n'click 4.4.0 r1, documentation revision · révision de la documentation 8dc717c69acb62c4742b69c54a7e7dfb620f75d8.
Earlier versions and permalinks · versions précédentes et liens permanents: https://wanoo.github.io/quest-n-click/docs/
An edit made in this wiki is overwritten at the next publication · une modification faite dans ce wiki est écrasée à la publication suivante.
Edit the source · Modifier la source · Report an error · Signaler une erreur
Index (6)
Start (6)
Play (9)
Install (17)
- Requirements
- Install from the release archive
- Install from npm, once published
- Install from the repository to work on the engine
- doctor: checking your machine
- Image toolchain
- Audio toolchain: ffmpeg, fluidsynth, Furnace, uv
- Upgrade
- Upgrade notes: 4.4
- Upgrade notes: 4.3
- Upgrade notes: 4.2
- Upgrade notes: 4.1
- Upgrade notes: v3
- Upgrade notes: v2 to v3
- Coming from web-scumm
- Package reference
- Install troubleshooting
Create a game (55)
- Your first game
- Layout of a created project and of the engine repository
- The working loop
- Content principles and the identity contract
- Rooms
- Geometry: placement, walk zones, masks, layers, camera
- Something is visible but unreachable
- Reactions
- Game commands
- Conditions
- Flags, variables and events: which to use
- Custom code
- Characters
- Items and inventory
- World map
- Dialogues
- Scripts and events
- Moving characters: patrols and walks
- Exits
- Chapters and objectives
- State and saves: persistent or temporary, renaming an id, migrations
- Staging: wide rooms and animations
- The stage: lights, particles, floors
- Skin and fonts
- Title and credits
- Heroes: several characters and hero choice
- Built-in minigames
- A custom minigame
- Translations
- Music in stems
- Sound effects
- Voices: per language and per hero
- Images: prompts, cutting sheets, transparency, scale
- Asset provenance
- The storyboard, source of truth
- Puzzle design
- Classic mechanics
- Review pages
- DSL reference
- Checking your game
- What the solver proves
- Solver options
- Playtests
- Remix
- Speedrun for authors
- The sealed ending
- Production template
- Example games
- Working with an AI
- Build and release a game
- Publish on GitHub Pages
- The static game on Clever Cloud
- Other static hosts
- Sub-path, cache and service worker, incomplete deploys, going back
- Testing on a phone over the LAN
Local Studio (24)
- The local Studio: overview and launch
- Edit a room
- Placement and stage
- Preview, apply, undo
- Storyboard
- Assets and cutting
- Check: validator, solver, critical path, heat, health, coverage
- Before and after captures
- Semantic diff
- Play and replay a session
- Rule explainer
- Language and objectives
- Voices and the heroes × languages matrix
- Map
- Notes
- Remix in the Studio
- Music
- The Assistant: bring your own key
- Demo mode and studio-apply
- Local and LAN security
- Studio API
- Local MCP: setting up each client
- MCP tools
- Studio troubleshooting
Team Studio (21)
- What runs where
- Concepts: revision, transaction, span, lease, preview, build
- Starting as an invited dev
- Working together day to day
- Roles and actions: the full matrix
- Invitations
- Managing members
- Write refused on the hosted Studio: stale base revision (409)
- Write refused on the hosted Studio: span locked (423)
- Recovering after a lost lease, a disconnection or a stale preview
- Comments
- Map and semantic diff
- Publishing builds
- Remote MCP
- The game in Git
- Upgrading the engine of a hosted game
- Hosted assets
- The server's command line
- Health and metrics routes
- Trying it locally with compose.yml
- Known limits
Clever Cloud (23)
- Clever Cloud: overview, cost and prerequisites
- Apps and add-ons
- Domains and TLS
- Keycloak
- Generic OIDC and GitLab
- Configuration
- First deployment
- Backups
- RPO and RTO
- Restore the Studio on a fresh installation
- Redeploys
- Upgrading the server and checking state after a migration
- Limits of going back
- Monitoring
- Security
- Rotating keys
- Recovering admin access
- Changing domain or OIDC provider
- Worker, PostgreSQL or Cellar down
- Exporting the game and leaving the installation
- Retention
- Clever Cloud troubleshooting
- Costs and teardown
Reality Bridge and connectors (16)
- The Reality Bridge: what it is
- Quick start
- Guarantees
- Install and run the Bridge
- Backup and restore
- Several tenants
- Signals and the manifest
- The Bridge's command line
- Connectors overview
- Email connector
- Telnet connector
- SSH connector
- Open Badges connector
- The connector SDK
- Security: Biscuit and signatures
- Bridge and connector troubleshooting
Contribute (25)
- Welcome
- Developer setup
- The dev loop
- Before a pull request
- Conventions
- Writing documentation
- Architecture
- Code tour
- Import boundaries
- Which tests run when
- Mutation testing
- The coverage ratchet
- The quality baseline
- CI explained
- Field passes
- Benchmarks
- Releasing
- npm packages
- Decisions and ADRs
- Governance
- Bot pull requests
- Contributing with AI agents
- Security policy
- Code of conduct
- Licences and credits