Yjs Coauthoring

SynckHub mints session tokens and callback endpoints. The yjs-wopi runtime is deployed separately.

Required components

• SynckHub server configured for yjs token/callback secrets
• yjs_wopi runtime service
• yjs_transformer service
• valid image pins for both services

Required secrets

• SYNCKHUB_YJS_WOPI_TOKEN_SECRET
• SYNCKHUB_YJS_WOPI_CALLBACK_SECRET

Routing model

Recommended model is same-origin routing through your edge:

• WebSocket route for /ws/:doc_id
• explicit close route for /v0/sessions/close

Operational rule

If any yjs-wopi config is set, treat integration as enabled and enforce all required values.

Partial configuration is a deployment bug, not a tolerated state.