remo · documentation
AI RU

Troubleshooting

Symptom → cause → what to check: sign-in, socket, saving, export, webhook, agents.

Status: available updated 2026-11-06

Sign-in and access

Symptom Cause What to check
Sign-in appears to succeed, but there is no session no HTTPS at NODE_ENV=production the Secure cookie is not stored without TLS
401 AUTH_REQUIRED with an account present the cookie is lost or has expired session lifetime 30 days, the domain and SameSite
403 FORBIDDEN on an action the role does not give the capability the role table and role sources
403 UNCLAIMED in a room the room has no owner claim the room from its link; if that is not possible, ask the installation operator to assign an owner or archive it; there is no automatic deletion
404 in a room that exists another account or organisation access and ?org=<slug> in the address
The link does not open disabled, expired, or the password changed the Public link block
No discussion is visible you opened a link without an account, or the role is below Commenter the account and the room role
A lock cannot be released another person locked the object ask the author or a room manager

Socket and saving

4429 and 4413 are socket close codes, not API responses. In both cases the edits stay in the current tab and leave after the next connection.

Symptom Cause What to check
Edits are not visible to others the socket is not connected the indicator, 101 Switching Protocols in the network tab
The indicator stays on connecting the proxy does not pass WebSocket location /sync/ and the Upgrade headers
офлайн (N) (offline) does not clear the connection has not been restored the network, then reload the tab
ввод остановлен (input stopped) the queue reached 1000 changes restore the connection; edits in the queue are kept
The connection closed with 4429 the write budget is exceeded: 256 KiB/s per socket (16 MiB burst) or 2 MiB/s per organisation (64 MiB burst) the size of the edit and the number of open tabs; retry in 5 s, then the pause grows to 60 s
The connection closed with 4413 the room is full: 64 MiB or 20 000 objects the room size, the object count and recent large pastes; retry in 30 s, then the pause grows to 5 min
A frame above 16 MiB is not accepted the edit is above the single-frame ceiling make the paste smaller or split it; the room may not be full at all
A paste does not pass in a full room the edit is above 16 KiB while the room is at its size ceiling split the paste; edits to existing objects are still saved
New objects are not created the ceiling of 20 000 objects is reached the object count; changes to existing objects are saved, new ones are refused
After access is revoked, edits are not accepted the tab is in read-only mode this is expected behaviour

Export and backup

Symptom Cause What to check
"Nothing to export in this scope" nothing is selected for the chosen scope select objects or a frame
No backup option the role lacks board.backup an editor role and above
Import refused a damaged file or a wrong checksum the integrity of the JSON and manifest
The PDF is empty rendering happens in the browser disabled extensions, room size

Events and integrations

Symptom Cause What to check
The event did not arrive the endpoint is not configured or does not answer 2xx GET …/webhook/deliveries
Events pile up in the DLQ the endpoint is consistently unreachable dead=1, lastError, then replay
401 INTEGRATION_TOKEN_* the token is unknown, revoked, or expired issue a new one
403 SCOPE_REQUIRED the token does not have the required scope board.read / board.edit
409 WEBHOOK_LOCKED REMO_KEK is not set the key and its reserve

Agents

Symptom Cause What to check
AI_NOT_CONFIGURED there is no provider key REMO_AI_* or the key in the interface
AGENT_DENIED agents are off, there are no permissions, or the skill is forbidden the organisation policy and the owner role
BUDGET_REQUIRED a task without a budget set a budget
The task is queued the limit of concurrent tasks wait or reduce the load

Documentation

Symptom Cause What to check
/guide/ answers 404 the portal is not built or not copied pnpm guide:build, rsync to /srv/remo/docs-site/
/guide/ opens but /help/… does not work local viewing on a different port in production both are on the same origin

Where to go next

Known issues and limitations — limitations that are not defects.