Back up, restore, update, and troubleshoot Roomote after your first task.
Use this guide after installing Roomote and
completing your first task. These commands apply to deployments
created with the Linux installer. For a hosting platform, follow its
deployment guide for lifecycle operations.Run host commands on the Linux machine running Roomote. Use sudo if your
account needs it to access the deployment.
Day-2 operations
The installer also sets up the roomote host CLI for common operations:
roomote upgrade # pull and roll out newer imagesroomote rollback # return to the release before the last upgraderoomote backup # create an encrypted deployment recovery bundleroomote logs # tail service logs
roomote backup prompts for a passphrase and writes a versioned .roomote
bundle under /opt/roomote/backups. The bundle contains PostgreSQL, the
deployment configuration and encryption/signing keys, local MinIO artifacts,
schema metadata, the exact deployed image identities, and both the Memory volume
and isolated Memory database when the brain profile is enabled. Store the
passphrase separately in your secret manager; the backup cannot be restored
without it.Webhook and delivery lifecycle entries in roomote logs use single-line JSON
with an event field plus safe correlation fields such as provider, delivery,
session, task, run, and job IDs. Search these entries to follow Telegram
messages and GitHub pull-request review activity from receipt through
persistence, dispatch, and final delivery. Message bodies, raw payloads,
credentials, signatures, and token-bearing URLs are excluded.Use roomote backup --include-redis when queued work, BullMQ schedules,
sessions, and other transient Redis state must survive. Backups briefly stop
application writers (and active Docker task workers) so the included stores
share a documented consistency point. If object storage is external, the
bundle records its endpoint and bucket but does not copy its objects; keep a
provider-level backup of that bucket.Roomote exposes /health/bullmq for queue-processing health. It returns healthy
only when the background worker has recently processed its heartbeat job and no
session event has remained queued for more than five minutes. Any overdue event
makes the check fail; authenticated error responses report the overdue count,
while unauthenticated responses omit diagnostics. Use it alongside container
liveness and roomote logs: a stale heartbeat or growing backlog can reveal a
worker process that is still running but no longer draining jobs.Restore only after installing Roomote on the replacement host:
roomote restore /path/to/backup.roomote --yes
Restore verifies the encrypted bundle and checksums before replacing any
state, restores the original .env (including ENCRYPTION_KEY), repopulates
empty PostgreSQL/MinIO/Redis volumes, and starts the recorded Roomote release.
Upgrades and rollback
roomote upgrade is designed so a bad release cannot strand your deployment:
A backup comes first. Every upgrade creates an encrypted pre-upgrade
bundle under /opt/roomote/backups before anything changes. Pass a
passphrase with --backup-passphrase-file (or ROOMOTE_BACKUP_PASSPHRASE);
otherwise one is generated and stored next to the bundle. Use
--skip-backup to opt out.
Migrations run before services are replaced. Database migrations apply
in a single transaction while the previous release keeps serving. The bundled
migration runner makes up to three total attempts after a transient Postgres
connection failure: the initial run plus at most two retries. If migration
still fails, the schema rolls back, the previous configuration is restored,
and the previous release stays up.
Rollback is one command. Every release’s schema keeps the previous
release working, so roomote rollback re-deploys the prior release without
touching the database. roomote upgrade <tag> does the same for any
retained tag, and restoring the pre-upgrade bundle is the last-resort path
that also rewinds data.
Use roomote upgrade instead of updating application image references alone.
The command refreshes the release’s Compose and Caddy configuration together;
mixing newer application images with an older Caddyfile can leave routes used
by the new controller unavailable until the deployment configuration is also
updated.The supported rollback target is the release immediately before the current
one. Check the running application version and applied schema migration at any
time under Settings → Deployment → Diagnostics; both are also recorded in
every backup bundle’s manifest.When upgrading from Roomote 1.19.5 or earlier to 1.19.6 or later, upgrade all
servers handling sign-in and account linking together. Restart any sign-in or
account-linking attempts begun before the upgrade. Existing signed-in sessions
are retained, and registered OAuth callback URLs do not need to change.Roomote surfaces release history and available updates in the web app:
Admins on self-hosted deployments see an update notice in the sidenav when
a newer GitHub release is available. The update dialog keeps that target and
its GitHub link visible even when the running image does not yet contain the
newer release’s notes. Use roomote upgrade (or your image roll-forward
process) to install it.
Everyone can open About Roomote and select See all Roomote releases
to browse the current and previous release notes bundled in the running
image, with the latest release expanded. After an upgrade, Roomote also shows
the latest “what’s new” notice once.
HTTP telemetry after upgrading to Roomote 1.21.0
Roomote 1.21.0 includes an OpenTelemetry HTTP instrumentation security update
that redacts sensitive signed-URL query parameters in incoming request spans.
The updated instrumentation emits only stable HTTP semantic conventions;
legacy and duplicate HTTP attributes and metrics are removed, regardless of
OTEL_SEMCONV_STABILITY_OPT_IN.If you collect HTTP telemetry for custom dashboards or alerts, review your
collector processing and queries before upgrading. Update references to legacy
fields and metrics to the stable conventions, and verify that request counts,
latency charts, and error alerts still receive data after the upgrade. See
OpenTelemetry’s HTTP semantic-convention migration guide
for the field, metric, and unit changes. This affects instrumented HTTP signals,
not Roomote’s in-app Cost Analytics.
Worker runtime and saved snapshots
The worker image ships Node 22.23.4, and the TLS trust minimum is Node 22.23.4,
24.22.1 or 26.12.1 (or a newer patch within those branches). When an older image
or saved snapshot starts, worker bootstrap logs a warning and continues.
Starting with Roomote 1.19.1, tasks skip environment snapshots built by another
release, or with no recorded release, and run environment setup from scratch
instead of failing during worker startup. After an upgrade, initial task starts
can therefore take longer. Roomote checks for stale environment snapshots every
five minutes and queues replacements from the current image, with rebuilds paced
across environments; the daily refresh remains in place too. Rebuild custom
worker images yourself, and migrate or update saved task snapshots you intend to
keep using. The fresh-start fallback applies to environment snapshots, not saved
task snapshots. Starting with Roomote 1.19.2, follow-ups can resume saved task
snapshots created with an older release: worker startup warns about the older
image and continues, preserving the task’s files. The installed worker must still
match the application release. This does not update tools inside the snapshot.An application upgrade does not replace tools or certificate bundles inside an
existing snapshot. Update its OS certificates, Python environments and independent
harness binaries too, and recreate warm sandboxes. A successful browser or curl
check does not verify every application’s TLS trust store.The trust updates in Roomote 1.19.0 are partial remediation, not a fleet-wide
TLS guarantee. Bun/Brain/OpenCode, MinIO/mc, and other independent verifiers
require separate updates and verification. Environment snapshots pick up the
updated runtime when rebuilt, including the automatic post-upgrade rebuilds in
Roomote 1.19.1 and later. Rebuild custom worker images, migrate
saved task snapshots you keep, and restart affected running tools; upgrading the
application alone does not update them.
Rotate the encryption key
Encryption-key rotation requires Roomote 1.19.0 or later on every service.
Before changing any keys, upgrade all services to images that include this
feature. Older releases, including v1.18.2, do not support
ENCRYPTION_KEY_PREVIOUS or the reencrypt-secrets command.
ENCRYPTION_KEY encrypts the secrets Roomote stores in PostgreSQL:
integration credentials and OAuth tokens, environment variables, API keys,
webhook secrets, and generated auth keypairs. Changing it alone makes every
stored secret unreadable. Rotate it in two phases instead, keeping the old key
available until every stored value has been re-encrypted.
Take a backup. Run roomote backup so you can return to the old key and
data if anything goes wrong.
Decide what signs sign-in sessions. If BETTER_AUTH_SECRET is unset,
sessions are signed with the encryption key. During the rotation Roomote
keeps signing them with ENCRYPTION_KEY_PREVIOUS, so users stay signed in,
but removing the previous key in step 7 would switch session signing to the
new key and sign everyone out. To avoid that, set BETTER_AUTH_SECRET in
/opt/roomote/.env now: to the old ENCRYPTION_KEY value to keep existing
sessions, or to a new random value (openssl rand -base64 32) if you are
rotating because the old key may be exposed. A new value signs everyone out
once. The Compose file passes it to the web service, which signs sessions;
it takes effect with the roomote up in the next step.
Install the new key. In /opt/roomote/.env, move the current value to
ENCRYPTION_KEY_PREVIOUS and set a new ENCRYPTION_KEY:
ENCRYPTION_KEY_PREVIOUS=<old key>ENCRYPTION_KEY=<output of openssl rand -base64 32>
Both must be at least 32 characters. Apply them with roomote up, which
recreates the services with the new environment. Roomote now writes every
new or updated secret with the new key and reads older ones with the
previous key.
The command lists every table and column that holds encrypted values with
counts of rows already on the current key (current), rows with values
that would be rewritten (migrated), rows with values that open with
neither key (unreadable), rows that are not encrypted at all
(not_encrypted), and rows still holding a previous-key value
(remaining_on_previous). A row that stores several secrets, such as a
custom MCP server’s headers, can count as both migrated and
unreadable. Nothing is written.
Re-encrypt. Run the same command without --dry-run. It works in
batches, rewrites only values that still use the previous key (leaving
unreadable values in the same row untouched), and never
overwrites a value that changes while it runs; such rows are reported as
conflicts. It is safe to run again at any time.
Verify. Run the dry run again. When it reports
No rows remain on the previous key, the rotation is complete. The command
exits non-zero while any row is unreadable or conflicted; re-run it for
conflicts. Unreadable rows were already unreadable before the rotation
(they were written with some other key); re-save those secrets in Roomote.
Remove the previous key. Delete ENCRYPTION_KEY_PREVIOUS from .env
and run roomote up again. Keep the old key in your secret manager until
you no longer need backups taken before the rotation, since those backups
still contain data encrypted with it.
On a hosting platform, set ENCRYPTION_KEY_PREVIOUS and the new
ENCRYPTION_KEY on every service that has ENCRYPTION_KEY (web, api, bullmq,
and controller), set BETTER_AUTH_SECRET on the web service, redeploy, and run
/roomote/.docker/app/entrypoint.sh reencrypt-secrets --dry-run from a shell
in the api service. The previous key is never passed to task sandboxes.The encryption key also keys a few non-secret identifiers. Credential
substitutes issued to runs that are in progress during step 3 stop matching
until the run restarts or resumes, and provider usage-limit alerts may repeat
once because their credential fingerprints change.
Common issues
Callbacks fail. For providers that use callbacks or webhooks, confirm the
deployment has a public HTTPS URL and that the provider is using that exact
URL. Discord uses its Gateway service instead of a public callback.
The first task cannot clone a repository. Workers authenticate git with a
short-lived GitHub App installation token created when the run starts — they
do not read a GH_TOKEN/GITHUB_TOKEN from the container environment. If a
task fails with “No GitHub credentials are available”, verify the GitHub App
is installed for the repository owner, the installation covers the
repository, and the repository appears in the source-control settings after a
sync.
The agent cannot run useful commands. Add missing services, environment
variables, setup commands, or tool versions to the environment.
Chat messages do not reach Roomote. Confirm the app is installed, invited
to the channel, and using the current callback URL.
Roomote reports that local working storage is full. Clean up container
storage, then recreate the affected application containers. Installer-managed
Compose deployments can raise ROOMOTE_APP_TMPFS_SIZE above its 512m
default before recreating them; keep the limit within the host’s available
memory.
Memory climbs for hours, or a service is OOM-killed under a container
memory limit. Node sizes its heap from the memory it can see (the host’s,
not the container’s), so it defers garbage collection and lets memory drift
well above what the service needs; a container memory cap then kills the
process before Node ever feels pressure. Current app images cap each Node
service’s heap by default (768 MB for web and api, 512 MB for controller and
bullmq, reduced to ~75% of the container’s memory when a cgroup limit is
set). Set NODE_OPTIONS=--max-old-space-size=<MB> on a service to override
the default, or on older images to add the cap manually.
Decision model on CPU (optional)
Roomote asks a decision model small typed questions: whether a turn is worth
remembering, who a thread reply is for, when a running task has news for the
user, which model a delegated task should use. With a TypeSafe key, Jev
answers them. Without one, the judgment profile runs a CPU decision model
beside the stack, so these features work with no external decision API and no
GPU.Add these to .env:
COMPOSE_PROFILES=judgment # or append to an existing listR_JUDGMENT_UPSTREAM_URL=http://judgment:8080R_JUDGMENT_MODEL=roomote # or choose it in Settings > Models
The sidecar serves
roomote/roomote-judgment-gliner,
a GLiNER 2.5 model fine-tuned on Roomote’s decisions and trained only on
synthetic data. It downloads the model on first start and keeps it in the
roomote_judgment_models volume. Its model card lists the decisions it covers
and its accuracy; on real decisions it trails Jev by a few points, and Roomote
acts on a decision only when the model is confident and the decision is in its
evaluated policy. Unsupported decisions keep their existing safe fallback. To
serve a different checkpoint, set JUDGMENT_MODEL to a Hugging Face id or path
(and JUDGMENT_HF_TOKEN if it is private).The sidecar is reachable only on the stack’s internal network; set
R_JUDGMENT_UPSTREAM_API_KEY as well to require a bearer token.Sizing: the container is capped at JUDGMENT_MEMORY_LIMIT (default 4g) and
JUDGMENT_CPUS (default 4). It uses about 1.5 GB, and on 4 cores a decision
takes about 0.3 to 1 second (p90 about 2 seconds). Decisions run one at a
time, so a burst of them queues and more cores make each one faster.The production install (install.sh) and the Railway, Render, and Coolify
templates carry the same service, opt-in like Memory: in the production
install it is the judgment profile, and in the templates it idles without
loading its model until R_JUDGMENT_UPSTREAM_URL points at it and the
Roomote judgment model is selected. Each template’s README has the steps.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Roomote Docs","description":"Documentation for Roomote, the open, self-hostable platform for cloud coding agents.","colors":{"primary":"#B0CD26","light":"#D6EE26","dark":"#B0CD26"},"logo":{"light":"https://docs.roomote.dev/logo/light.svg","dark":"https://docs.roomote.dev/logo/dark.svg","href":"https://docs.roomote.dev"},"favicon":"https://mintcdn.com/roocode/jcTIWgKmjs94WhSu/favicon.png?fit=max\u0026auto=format\u0026n=jcTIWgKmjs94WhSu\u0026q=85\u0026s=74880d487bd4434634770b3aadbad452","navbar":{"links":[{"icon":"external-link","href":"https://roomote.dev","label":"Go to roomote.dev"}]},"footer":{"socials":{"github":"https://github.com/RooCodeInc/Roomote"}},"fonts":{"family":"DM Sans"},"icons":{"library":"lucide"},"thumbnails":{"appearance":"light","background":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/data:image/svg+xml,%3Csvg%20xmlns=%22http:/www.w3.org/2000/svg%22%20width=%221200%22%20height=%22630%22%3E%3Crect%20width=%221200%22%20height=%22630%22%20fill=%22%23D6EE26%22/%3E%3C/svg%3E","fonts":{"family":"DM Sans"}},"markdown":{"instructions":["Start new users at /index, then /self-hosting to choose and prepare a host, including home networks at /homelab or infrastructure providers at /self-hosting/platforms. Continue through /first-task. Use Local development only when the user intends to modify Roomote itself.","When an agent is asked to follow /self-hosting or install Roomote autonomously, read and follow /self-hosting/agent-installation as the normative automation contract even though it is intentionally hidden from side navigation.","Use the one-command Linux installer for both evaluation and production. On macOS or Windows, create or reuse a full Ubuntu VM and run the same installer inside it; do not replace the installer with the repository's development Compose files.","For a local VM, prepare a stable public HTTPS domain before connecting providers. Use a named tunnel with internal origin TLS or public DNS with ports 80/443 forwarded to the Linux host. Cloudflare Quick Tunnels do not support the Server-Sent Events Roomote uses; do not use them for the complete setup path.","Run automated installs with --no-setup-url so the bootstrap token is not captured in the agent transcript. Let the user obtain the setup URL in a trusted terminal, enter credentials, and complete browser authorization.","Proceed through safe, reversible setup and pause for privileged host or VM changes, public tunnel creation, credentials or browser authorization, durable external-account changes, destructive operations, existing-state conflicts, or when no documented safe default applies.","A setup is not complete when the services merely start. Follow /first-task to verify sign-in, repository sync, and a real Roomote task that can clone and run a command. A saved environment is optional for a repository task. Verify branch or pull-request delivery and previews when configured; Slack and other communications providers are optional."]},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"roocode","hasAudioNarration":false,"actualSubdomain":"roocode","customDomains":["docs.roomote.dev"],"gitSource":{"type":"github","owner":"roocodeinc","repo":"roomote","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afcdfdef906b303e5c16b4a","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Configuring Providers","count":45},{"language":"default","tag":"Integrations","count":31},{"language":"default","tag":"Models and inference","count":28},{"language":"default","tag":"Using Roomote","count":11},{"language":"default","tag":"Configuring Roomote","count":7},{"language":"default","tag":"Automating Work","count":7},{"language":"default","tag":"Sandboxes","count":7},{"language":"default","tag":"Getting started","count":5},{"language":"default","tag":"Communications","count":5},{"language":"default","tag":"Source control","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"roomote.css","content":"@font-face{font-family:'Monaspace Neon';font-style:normal;font-weight:400;font-display:swap;src:url('/fonts/monaspace-neon-latin-400-normal.woff2') format('woff2')}@font-face{font-family:'Monaspace Neon';font-style:normal;font-weight:500;font-display:swap;src:url('/fonts/monaspace-neon-latin-500-normal.woff2') format('woff2')}@font-face{font-family:'Monaspace Neon';font-style:normal;font-weight:700;font-display:swap;src:url('/fonts/monaspace-neon-latin-700-normal.woff2') format('woff2')}:root{--roomote-lime: #b0cd26;--roomote-lime-light: #d6ee26;--roomote-code-font:\n 'Monaspace Neon', ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas,\n 'Liberation Mono', 'Courier New', monospace;--roomote-radius: 0.75rem}code,pre,kbd,samp,.font-mono,[class*=\"language-\"]{font-family:var(--roomote-code-font)}pre,img,.rounded-lg,.rounded-xl{border-radius:var(--roomote-radius)}nav a[href=\"https://roomote.dev\"],.navbar a[href=\"https://roomote.dev\"]{display:inline-flex;align-items:center;gap:0.35rem}nav a[href=\"https://roomote.dev\"] svg,.navbar a[href=\"https://roomote.dev\"] svg{order:2}.integration-name{display:inline-flex;align-items:center;gap:0.45rem;width:max-content;max-width:100%;padding:0;border:0!important;background:none!important;line-height:1.2;vertical-align:middle;box-shadow:none!important}.integration-logo{display:inline-block;width:1rem;height:1rem;flex:0 0 auto;margin:0!important;vertical-align:middle}.integration-logo,img[src^=\"https://api.iconify.design/simple-icons/\"],img[src^=\"https://api.iconify.design/simple-icons:\"],img[src^=\"https://unpkg.com/@lobehub/icons-static-svg@\"],img[src*=\"/logo/integrations/\"],img[src*=\"/favicon.svg\"]{border-radius:0}.integration-name [data-rmiz],.integration-name [data-rmiz-content]{display:inline-flex!important;align-items:center;flex:0 0 auto;margin:0!important}.dark img[src^=\"https://api.iconify.design/simple-icons/\"],.dark img[src^=\"https://api.iconify.design/simple-icons:\"]{filter:invert(1)}.dark img[src^=\"https://unpkg.com/@lobehub/icons-static-svg@\"]{filter:invert(1)}.dark img[src*=\"/logo/integrations/\"]{filter:invert(1)}.dark img[src*=\"/favicon.svg\"]{filter:invert(1)}@media (max-width: 767px){[role=\"status\"][aria-live=\"polite\"][class~=\"z-999\"]{display:none}}"}]}
{"page":{"pagePath":"self-hosting/operations","slug":"/self-hosting/operations","pageMetadata":{"title":"Operate a self-hosted deployment","icon":"wrench","description":"Back up, restore, update, and troubleshoot Roomote after your first task.","href":"/self-hosting/operations"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Back up, restore, update, and troubleshoot Roomote after your first task.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Use this guide after `,_jsx(_components.a,{href:`/self-hosting`,children:`installing Roomote`}),` and\n`,_jsx(_components.a,{href:`/first-task`,children:`completing your first task`}),`. These commands apply to deployments\ncreated with the Linux installer. For a hosting platform, follow its\n`,_jsx(_components.a,{href:`/self-hosting/platforms`,children:`deployment guide`}),` for lifecycle operations.`]}),`\n`,_jsxs(_components.p,{children:[`Run host commands on the Linux machine running Roomote. Use `,_jsx(_components.code,{children:`sudo`}),` if your\naccount needs it to access the deployment.`]}),`\n`,_jsx(Heading,{level:`2`,id:`day-2-operations`,children:`Day-2 operations`}),`\n`,_jsxs(_components.p,{children:[`The installer also sets up the `,_jsx(_components.code,{children:`roomote`}),` host CLI for common operations:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`roomote`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` upgrade`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # pull and roll out newer images`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`roomote`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` rollback`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # return to the release before the last upgrade`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`roomote`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` backup`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # create an encrypted deployment recovery bundle`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`roomote`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` logs`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # tail service logs`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`roomote backup`}),` prompts for a passphrase and writes a versioned `,_jsx(_components.code,{children:`.roomote`}),`\nbundle under `,_jsx(_components.code,{children:`/opt/roomote/backups`}),`. The bundle contains PostgreSQL, the\ndeployment configuration and encryption/signing keys, local MinIO artifacts,\nschema metadata, the exact deployed image identities, and both the Memory volume\nand isolated Memory database when the `,_jsx(_components.code,{children:`brain`}),` profile is enabled. Store the\npassphrase separately in your secret manager; the backup cannot be restored\nwithout it.`]}),`\n`,_jsxs(_components.p,{children:[`Webhook and delivery lifecycle entries in `,_jsx(_components.code,{children:`roomote logs`}),` use single-line JSON\nwith an `,_jsx(_components.code,{children:`event`}),` field plus safe correlation fields such as provider, delivery,\nsession, task, run, and job IDs. Search these entries to follow Telegram\nmessages and GitHub pull-request review activity from receipt through\npersistence, dispatch, and final delivery. Message bodies, raw payloads,\ncredentials, signatures, and token-bearing URLs are excluded.`]}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`roomote backup --include-redis`}),` when queued work, BullMQ schedules,\nsessions, and other transient Redis state must survive. Backups briefly stop\napplication writers (and active Docker task workers) so the included stores\nshare a documented consistency point. If object storage is external, the\nbundle records its endpoint and bucket but does not copy its objects; keep a\nprovider-level backup of that bucket.`]}),`\n`,_jsxs(_components.p,{children:[`Roomote exposes `,_jsx(_components.code,{children:`/health/bullmq`}),` for queue-processing health. It returns healthy\nonly when the background worker has recently processed its heartbeat job and no\nsession event has remained queued for more than five minutes. Any overdue event\nmakes the check fail; authenticated error responses report the overdue count,\nwhile unauthenticated responses omit diagnostics. Use it alongside container\nliveness and `,_jsx(_components.code,{children:`roomote logs`}),`: a stale heartbeat or growing backlog can reveal a\nworker process that is still running but no longer draining jobs.`]}),`\n`,_jsx(_components.p,{children:`Restore only after installing Roomote on the replacement host:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`roomote`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` restore`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` /path/to/backup.roomote`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --yes`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Restore verifies the encrypted bundle and checksums before replacing any\nstate, restores the original `,_jsx(_components.code,{children:`.env`}),` (including `,_jsx(_components.code,{children:`ENCRYPTION_KEY`}),`), repopulates\nempty PostgreSQL/MinIO/Redis volumes, and starts the recorded Roomote release.`]}),`\n`,_jsx(Heading,{level:`2`,id:`upgrades-and-rollback`,children:`Upgrades and rollback`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`roomote upgrade`}),` is designed so a bad release cannot strand your deployment:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A backup comes first.`}),` Every upgrade creates an encrypted pre-upgrade\nbundle under `,_jsx(_components.code,{children:`/opt/roomote/backups`}),` before anything changes. Pass a\npassphrase with `,_jsx(_components.code,{children:`--backup-passphrase-file`}),` (or `,_jsx(_components.code,{children:`ROOMOTE_BACKUP_PASSPHRASE`}),`);\notherwise one is generated and stored next to the bundle. Use\n`,_jsx(_components.code,{children:`--skip-backup`}),` to opt out.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Migrations run before services are replaced.`}),` Database migrations apply\nin a single transaction while the previous release keeps serving. The bundled\nmigration runner makes up to three total attempts after a transient Postgres\nconnection failure: the initial run plus at most two retries. If migration\nstill fails, the schema rolls back, the previous configuration is restored,\nand the previous release stays up.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Rollback is one command.`}),` Every release’s schema keeps the previous\nrelease working, so `,_jsx(_components.code,{children:`roomote rollback`}),` re-deploys the prior release without\ntouching the database. `,_jsx(_components.code,{children:`roomote upgrade \u003ctag>`}),` does the same for any\nretained tag, and restoring the pre-upgrade bundle is the last-resort path\nthat also rewinds data.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`roomote upgrade`}),` instead of updating application image references alone.\nThe command refreshes the release’s Compose and Caddy configuration together;\nmixing newer application images with an older Caddyfile can leave routes used\nby the new controller unavailable until the deployment configuration is also\nupdated.`]}),`\n`,_jsxs(_components.p,{children:[`The supported rollback target is the release immediately before the current\none. Check the running application version and applied schema migration at any\ntime under `,_jsx(_components.strong,{children:`Settings → Deployment → Diagnostics`}),`; both are also recorded in\nevery backup bundle’s manifest.`]}),`\n`,_jsx(_components.p,{children:`When upgrading from Roomote 1.19.5 or earlier to 1.19.6 or later, upgrade all\nservers handling sign-in and account linking together. Restart any sign-in or\naccount-linking attempts begun before the upgrade. Existing signed-in sessions\nare retained, and registered OAuth callback URLs do not need to change.`}),`\n`,_jsx(_components.p,{children:`Roomote surfaces release history and available updates in the web app:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Admins`}),` on self-hosted deployments see an update notice in the sidenav when\na newer GitHub release is available. The update dialog keeps that target and\nits GitHub link visible even when the running image does not yet contain the\nnewer release’s notes. Use `,_jsx(_components.code,{children:`roomote upgrade`}),` (or your image roll-forward\nprocess) to install it.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Everyone`}),` can open `,_jsx(_components.strong,{children:`About Roomote`}),` and select `,_jsx(_components.strong,{children:`See all Roomote releases`}),`\nto browse the current and previous release notes bundled in the running\nimage, with the latest release expanded. After an upgrade, Roomote also shows\nthe latest “what’s new” notice once.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`http-telemetry-after-upgrading-to-roomote-1-21-0`,children:`HTTP telemetry after upgrading to Roomote 1.21.0`}),`\n`,_jsxs(_components.p,{children:[`Roomote 1.21.0 includes an OpenTelemetry HTTP instrumentation security update\nthat redacts sensitive signed-URL query parameters in incoming request spans.\nThe updated instrumentation emits only stable HTTP semantic conventions;\nlegacy and duplicate HTTP attributes and metrics are removed, regardless of\n`,_jsx(_components.code,{children:`OTEL_SEMCONV_STABILITY_OPT_IN`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`If you collect HTTP telemetry for custom dashboards or alerts, review your\ncollector processing and queries before upgrading. Update references to legacy\nfields and metrics to the stable conventions, and verify that request counts,\nlatency charts, and error alerts still receive data after the upgrade. See\n`,_jsx(_components.a,{href:`https://opentelemetry.io/docs/specs/semconv/non-normative/http-migration/`,children:`OpenTelemetry’s HTTP semantic-convention migration guide`}),`\nfor the field, metric, and unit changes. This affects instrumented HTTP signals,\nnot Roomote’s in-app Cost Analytics.`]}),`\n`,_jsx(Heading,{level:`3`,id:`worker-runtime-and-saved-snapshots`,children:`Worker runtime and saved snapshots`}),`\n`,_jsx(_components.p,{children:`The worker image ships Node 22.23.4, and the TLS trust minimum is Node 22.23.4,\n24.22.1 or 26.12.1 (or a newer patch within those branches). When an older image\nor saved snapshot starts, worker bootstrap logs a warning and continues.\nStarting with Roomote 1.19.1, tasks skip environment snapshots built by another\nrelease, or with no recorded release, and run environment setup from scratch\ninstead of failing during worker startup. After an upgrade, initial task starts\ncan therefore take longer. Roomote checks for stale environment snapshots every\nfive minutes and queues replacements from the current image, with rebuilds paced\nacross environments; the daily refresh remains in place too. Rebuild custom\nworker images yourself, and migrate or update saved task snapshots you intend to\nkeep using. The fresh-start fallback applies to environment snapshots, not saved\ntask snapshots. Starting with Roomote 1.19.2, follow-ups can resume saved task\nsnapshots created with an older release: worker startup warns about the older\nimage and continues, preserving the task’s files. The installed worker must still\nmatch the application release. This does not update tools inside the snapshot.`}),`\n`,_jsx(_components.p,{children:`An application upgrade does not replace tools or certificate bundles inside an\nexisting snapshot. Update its OS certificates, Python environments and independent\nharness binaries too, and recreate warm sandboxes. A successful browser or curl\ncheck does not verify every application’s TLS trust store.`}),`\n`,_jsx(_components.p,{children:`The trust updates in Roomote 1.19.0 are partial remediation, not a fleet-wide\nTLS guarantee. Bun/Brain/OpenCode, MinIO/mc, and other independent verifiers\nrequire separate updates and verification. Environment snapshots pick up the\nupdated runtime when rebuilt, including the automatic post-upgrade rebuilds in\nRoomote 1.19.1 and later. Rebuild custom worker images, migrate\nsaved task snapshots you keep, and restart affected running tools; upgrading the\napplication alone does not update them.`}),`\n`,_jsx(Heading,{level:`2`,id:`rotate-the-encryption-key`,children:`Rotate the encryption key`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Encryption-key rotation requires Roomote 1.19.0 or later on every service.\nBefore changing any keys, upgrade all services to images that include this\nfeature. Older releases, including v1.18.2, do not support\n`,_jsx(_components.code,{children:`ENCRYPTION_KEY_PREVIOUS`}),` or the `,_jsx(_components.code,{children:`reencrypt-secrets`}),` command.`]})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`ENCRYPTION_KEY`}),` encrypts the secrets Roomote stores in PostgreSQL:\nintegration credentials and OAuth tokens, environment variables, API keys,\nwebhook secrets, and generated auth keypairs. Changing it alone makes every\nstored secret unreadable. Rotate it in two phases instead, keeping the old key\navailable until every stored value has been re-encrypted.`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Take a backup.`}),` Run `,_jsx(_components.code,{children:`roomote backup`}),` so you can return to the old key and\ndata if anything goes wrong.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Decide what signs sign-in sessions.`}),` If `,_jsx(_components.code,{children:`BETTER_AUTH_SECRET`}),` is unset,\nsessions are signed with the encryption key. During the rotation Roomote\nkeeps signing them with `,_jsx(_components.code,{children:`ENCRYPTION_KEY_PREVIOUS`}),`, so users stay signed in,\nbut removing the previous key in step 7 would switch session signing to the\nnew key and sign everyone out. To avoid that, set `,_jsx(_components.code,{children:`BETTER_AUTH_SECRET`}),` in\n`,_jsx(_components.code,{children:`/opt/roomote/.env`}),` now: to the old `,_jsx(_components.code,{children:`ENCRYPTION_KEY`}),` value to keep existing\nsessions, or to a new random value (`,_jsx(_components.code,{children:`openssl rand -base64 32`}),`) if you are\nrotating because the old key may be exposed. A new value signs everyone out\nonce. The Compose file passes it to the web service, which signs sessions;\nit takes effect with the `,_jsx(_components.code,{children:`roomote up`}),` in the next step.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Install the new key.`}),` In `,_jsx(_components.code,{children:`/opt/roomote/.env`}),`, move the current value to\n`,_jsx(_components.code,{children:`ENCRYPTION_KEY_PREVIOUS`}),` and set a new `,_jsx(_components.code,{children:`ENCRYPTION_KEY`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ENCRYPTION_KEY_PREVIOUS`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=\u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`old`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` key`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ENCRYPTION_KEY`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=\u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`output`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` of`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` openssl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` rand`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -base64`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 3`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`2>`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Both must be at least 32 characters. Apply them with `,_jsx(_components.code,{children:`roomote up`}),`, which\nrecreates the services with the new environment. Roomote now writes every\nnew or updated secret with the new key and reads older ones with the\nprevious key.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Preview the re-encryption.`}),` From `,_jsx(_components.code,{children:`/opt/roomote`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`docker`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` compose`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --env-file`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` .env`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` docker-compose.prod.yml`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` exec`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -T`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` api`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` /roomote/.docker/app/entrypoint.sh`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` reencrypt-secrets`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --dry-run`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The command lists every table and column that holds encrypted values with\ncounts of rows already on the current key (`,_jsx(_components.code,{children:`current`}),`), rows with values\nthat would be rewritten (`,_jsx(_components.code,{children:`migrated`}),`), rows with values that open with\nneither key (`,_jsx(_components.code,{children:`unreadable`}),`), rows that are not encrypted at all\n(`,_jsx(_components.code,{children:`not_encrypted`}),`), and rows still holding a previous-key value\n(`,_jsx(_components.code,{children:`remaining_on_previous`}),`). A row that stores several secrets, such as a\ncustom MCP server’s headers, can count as both `,_jsx(_components.code,{children:`migrated`}),` and\n`,_jsx(_components.code,{children:`unreadable`}),`. Nothing is written.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Re-encrypt.`}),` Run the same command without `,_jsx(_components.code,{children:`--dry-run`}),`. It works in\nbatches, rewrites only values that still use the previous key (leaving\nunreadable values in the same row untouched), and never\noverwrites a value that changes while it runs; such rows are reported as\n`,_jsx(_components.code,{children:`conflicts`}),`. It is safe to run again at any time.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Verify.`}),` Run the dry run again. When it reports\n`,_jsx(_components.code,{children:`No rows remain on the previous key`}),`, the rotation is complete. The command\nexits non-zero while any row is unreadable or conflicted; re-run it for\nconflicts. Unreadable rows were already unreadable before the rotation\n(they were written with some other key); re-save those secrets in Roomote.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Remove the previous key.`}),` Delete `,_jsx(_components.code,{children:`ENCRYPTION_KEY_PREVIOUS`}),` from `,_jsx(_components.code,{children:`.env`}),`\nand run `,_jsx(_components.code,{children:`roomote up`}),` again. Keep the old key in your secret manager until\nyou no longer need backups taken before the rotation, since those backups\nstill contain data encrypted with it.`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`On a hosting platform, set `,_jsx(_components.code,{children:`ENCRYPTION_KEY_PREVIOUS`}),` and the new\n`,_jsx(_components.code,{children:`ENCRYPTION_KEY`}),` on every service that has `,_jsx(_components.code,{children:`ENCRYPTION_KEY`}),` (web, api, bullmq,\nand controller), set `,_jsx(_components.code,{children:`BETTER_AUTH_SECRET`}),` on the web service, redeploy, and run\n`,_jsx(_components.code,{children:`/roomote/.docker/app/entrypoint.sh reencrypt-secrets --dry-run`}),` from a shell\nin the api service. The previous key is never passed to task sandboxes.`]}),`\n`,_jsx(_components.p,{children:`The encryption key also keys a few non-secret identifiers. Credential\nsubstitutes issued to runs that are in progress during step 3 stop matching\nuntil the run restarts or resumes, and provider usage-limit alerts may repeat\nonce because their credential fingerprints change.`}),`\n`,_jsx(Heading,{level:`2`,id:`common-issues`,children:`Common issues`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Callbacks fail.`}),` For providers that use callbacks or webhooks, confirm the\ndeployment has a public HTTPS URL and that the provider is using that exact\nURL. Discord uses its Gateway service instead of a public callback.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The first task cannot clone a repository.`}),` Workers authenticate git with a\nshort-lived GitHub App installation token created when the run starts — they\ndo not read a `,_jsx(_components.code,{children:`GH_TOKEN`}),`/`,_jsx(_components.code,{children:`GITHUB_TOKEN`}),` from the container environment. If a\ntask fails with “No GitHub credentials are available”, verify the GitHub App\nis installed for the repository owner, the installation covers the\nrepository, and the repository appears in the source-control settings after a\nsync.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The agent cannot run useful commands.`}),` Add missing services, environment\nvariables, setup commands, or tool versions to the environment.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Chat messages do not reach Roomote.`}),` Confirm the app is installed, invited\nto the channel, and using the current callback URL.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Roomote reports that local working storage is full.`}),` Clean up container\nstorage, then recreate the affected application containers. Installer-managed\nCompose deployments can raise `,_jsx(_components.code,{children:`ROOMOTE_APP_TMPFS_SIZE`}),` above its `,_jsx(_components.code,{children:`512m`}),`\ndefault before recreating them; keep the limit within the host’s available\nmemory.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Memory climbs for hours, or a service is OOM-killed under a container\nmemory limit.`}),` Node sizes its heap from the memory it can see (the host’s,\nnot the container’s), so it defers garbage collection and lets memory drift\nwell above what the service needs; a container memory cap then kills the\nprocess before Node ever feels pressure. Current app images cap each Node\nservice’s heap by default (768 MB for web and api, 512 MB for controller and\nbullmq, reduced to ~75% of the container’s memory when a cgroup limit is\nset). Set `,_jsx(_components.code,{children:`NODE_OPTIONS=--max-old-space-size=\u003cMB>`}),` on a service to override\nthe default, or on older images to add the cap manually.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`decision-model-on-cpu-optional`,children:`Decision model on CPU (optional)`}),`\n`,_jsxs(_components.p,{children:[`Roomote asks a decision model small typed questions: whether a turn is worth\nremembering, who a thread reply is for, when a running task has news for the\nuser, which model a delegated task should use. With a TypeSafe key, Jev\nanswers them. Without one, the `,_jsx(_components.code,{children:`judgment`}),` profile runs a CPU decision model\nbeside the stack, so these features work with no external decision API and no\nGPU.`]}),`\n`,_jsxs(_components.p,{children:[`Add these to `,_jsx(_components.code,{children:`.env`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`COMPOSE_PROFILES`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`judgment`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # or append to an existing list`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`R_JUDGMENT_UPSTREAM_URL`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`http://judgment:8080`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`R_JUDGMENT_MODEL`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`roomote`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # or choose it in Settings > Models`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The sidecar serves\n`,_jsx(_components.a,{href:`https://huggingface.co/roomote/roomote-judgment-gliner`,children:_jsx(_components.code,{children:`roomote/roomote-judgment-gliner`})}),`,\na GLiNER 2.5 model fine-tuned on Roomote’s decisions and trained only on\nsynthetic data. It downloads the model on first start and keeps it in the\n`,_jsx(_components.code,{children:`roomote_judgment_models`}),` volume. Its model card lists the decisions it covers\nand its accuracy; on real decisions it trails Jev by a few points, and Roomote\nacts on a decision only when the model is confident and the decision is in its\nevaluated policy. Unsupported decisions keep their existing safe fallback. To\nserve a different checkpoint, set `,_jsx(_components.code,{children:`JUDGMENT_MODEL`}),` to a Hugging Face id or path\n(and `,_jsx(_components.code,{children:`JUDGMENT_HF_TOKEN`}),` if it is private).`]}),`\n`,_jsxs(_components.p,{children:[`The sidecar is reachable only on the stack’s internal network; set\n`,_jsx(_components.code,{children:`R_JUDGMENT_UPSTREAM_API_KEY`}),` as well to require a bearer token.`]}),`\n`,_jsxs(_components.p,{children:[`Sizing: the container is capped at `,_jsx(_components.code,{children:`JUDGMENT_MEMORY_LIMIT`}),` (default `,_jsx(_components.code,{children:`4g`}),`) and\n`,_jsx(_components.code,{children:`JUDGMENT_CPUS`}),` (default `,_jsx(_components.code,{children:`4`}),`). It uses about 1.5 GB, and on 4 cores a decision\ntakes about 0.3 to 1 second (p90 about 2 seconds). Decisions run one at a\ntime, so a burst of them queues and more cores make each one faster.`]}),`\n`,_jsxs(_components.p,{children:[`The production install (`,_jsx(_components.code,{children:`install.sh`}),`) and the Railway, Render, and Coolify\ntemplates carry the same service, opt-in like Memory: in the production\ninstall it is the `,_jsx(_components.code,{children:`judgment`}),` profile, and in the templates it idles without\nloading its model until `,_jsx(_components.code,{children:`R_JUDGMENT_UPSTREAM_URL`}),` points at it and the\nRoomote judgment model is selected. Each template’s README has the steps.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Operate a self-hosted deployment","icon":"wrench","description":"Back up, restore, update, and troubleshoot Roomote after your first task.","href":"/self-hosting/operations"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Day-2 operations","slug":"day-2-operations","depth":2,"children":[]},{"title":"Upgrades and rollback","slug":"upgrades-and-rollback","depth":2,"children":[{"title":"HTTP telemetry after upgrading to Roomote 1.21.0","slug":"http-telemetry-after-upgrading-to-roomote-1-21-0","depth":3,"children":[]},{"title":"Worker runtime and saved snapshots","slug":"worker-runtime-and-saved-snapshots","depth":3,"children":[]}]},{"title":"Rotate the encryption key","slug":"rotate-the-encryption-key","depth":2,"children":[]},{"title":"Common issues","slug":"common-issues","depth":2,"children":[]},{"title":"Decision model on CPU (optional)","slug":"decision-model-on-cpu-optional","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"roocode","siteName":"Roomote Docs","title":"Operate a self-hosted deployment - Roomote Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T23:14:42.092Z","originalFileLocation":"self-hosting/operations.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Back up, restore, update, and troubleshoot Roomote after your first task.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Roomote Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/roocode/OL8JGyX3R70KyH08/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/roocode/OL8JGyX3R70KyH08/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/roocode/OL8JGyX3R70KyH08/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/roocode/OL8JGyX3R70KyH08/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/roocode/OL8JGyX3R70KyH08/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/roocode/OL8JGyX3R70KyH08/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/roocode/OL8JGyX3R70KyH08/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/roocode/OL8JGyX3R70KyH08/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/roocode/OL8JGyX3R70KyH08/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Operate a self-hosted deployment - Roomote Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Back up, restore, update, and troubleshoot Roomote after your first task.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Roomote Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.roomote.dev/self-hosting/operations\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://roocode.mintlify.site/_mintlify/api/og/v2?division=Self-hosted\u0026amp;title=Operate+a+self-hosted+deployment\u0026amp;description=Back+up%2C+restore%2C+update%2C+and+troubleshoot+Roomote+after+your+first+task.\u0026amp;theme=1d4280e1c17b7abefebcd7cf\u0026amp;signature=4a7d9f64e0302603a7f568309b1eb443d3ee93dbefb394b8a69312b7805b1a06\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Operate a self-hosted deployment - Roomote Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Back up, restore, update, and troubleshoot Roomote after your first task.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://roocode.mintlify.site/_mintlify/api/og/v2?division=Self-hosted\u0026amp;title=Operate+a+self-hosted+deployment\u0026amp;description=Back+up%2C+restore%2C+update%2C+and+troubleshoot+Roomote+after+your+first+task.\u0026amp;theme=1d4280e1c17b7abefebcd7cf\u0026amp;signature=4a7d9f64e0302603a7f568309b1eb443d3ee93dbefb394b8a69312b7805b1a06\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/roocode/OL8JGyX3R70KyH08/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Roomote Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#B0CD26\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.roomote.dev/self-hosting/operations\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/self-hosting/operations.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.roomote.dev/#organization\",\"name\":\"Roomote Docs\",\"url\":\"https://docs.roomote.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://docs.roomote.dev/logo/light.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.roomote.dev#website\",\"name\":\"Roomote Docs\",\"url\":\"https://docs.roomote.dev\",\"publisher\":{\"@id\":\"https://docs.roomote.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.roomote.dev/self-hosting/operations#webpage\",\"url\":\"https://docs.roomote.dev/self-hosting/operations\",\"name\":\"Operate a self-hosted deployment\",\"description\":\"Back up, restore, update, and troubleshoot Roomote after your first task.\",\"dateModified\":\"2026-11-17T23:14:42.092Z\",\"isPartOf\":{\"@id\":\"https://docs.roomote.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.roomote.dev/self-hosting/operations#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.roomote.dev/self-hosting/operations#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting started\",\"item\":\"https://docs.roomote.dev\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Self-hosted\",\"item\":\"https://docs.roomote.dev/self-hosting\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Operate a self-hosted deployment\",\"item\":\"https://docs.roomote.dev/self-hosting/operations\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.roomote.dev/self-hosting/operations#article\",\"headline\":\"Operate a self-hosted deployment\",\"name\":\"Operate a self-hosted deployment\",\"description\":\"Back up, restore, update, and troubleshoot Roomote after your first task.\",\"url\":\"https://docs.roomote.dev/self-hosting/operations\",\"mainEntityOfPage\":{\"@id\":\"https://docs.roomote.dev/self-hosting/operations#webpage\"},\"dateModified\":\"2026-11-17T23:14:42.092Z\",\"publisher\":{\"@id\":\"https://docs.roomote.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.roomote.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Roomote Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Roomote Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/self-hosting/operations.md","siteName":"Roomote Docs","nav":{"global":null,"groups":[{"group":"Getting started","pages":[{"title":"Getting started","icon":"book-open","href":"/index"},{"group":"Self-hosted","icon":"server","root":{"title":"Self-hosting","icon":"server","href":"/self-hosting"},"expanded":false,"pages":[{"title":"Home network and homelab","icon":"house-plug","href":"/homelab"},{"title":"Hosting platforms","icon":"cloud-cog","description":"Deploy Roomote in your Railway, Render, or other hosting account, then run your first task.","href":"/self-hosting/platforms"},{"title":"Operate a self-hosted deployment","icon":"wrench","href":"/self-hosting/operations"}]},{"title":"Run your first task","icon":"play","description":"Connect a model and repository, run a small task, and review the result in your browser.","href":"/first-task"}]},{"group":"Using Roomote","pages":[{"title":"How Roomote works","icon":"workflow","href":"/how-roomote-works"},{"title":"Use cases","icon":"bot-message-square","href":"/use-cases"},{"title":"Review a task","icon":"clipboard-check","href":"/tasks"},{"title":"Live Previews","icon":"app-window","href":"/live-previews"},{"title":"Goal Mode","icon":"target","href":"/goal-mode"},{"title":"Sessions","icon":"messages-square","href":"/fast-sessions"},{"title":"Integration keys","icon":"key-round","href":"/integration-keys"},{"title":"Memory","icon":"book-open-text","href":"/memory"},{"title":"File attachments","icon":"paperclip","href":"/file-attachments"},{"title":"Voice","icon":"audio-lines","href":"/voice"},{"title":"Privacy","icon":"shield-check","href":"/privacy"}]},{"group":"Automating Work","pages":[{"title":"Automations","icon":"zap","href":"/automations"},{"title":"Configure automations","icon":"settings-2","href":"/automation-configuration"},{"title":"Custom automations","icon":"square-pen","href":"/custom-automations"},{"title":"Automation webhooks","icon":"webhook","href":"/automation-webhooks"},{"title":"Automation results","icon":"notepad-text","href":"/automation-results"},{"title":"Cookbook","icon":"cooking-pot","href":"/cookbook/index"},{"title":"Contributing recipes","icon":"plus","href":"/cookbook/template"}]},{"group":"Configuring Providers","pages":[{"group":"Models and inference","icon":"brain","root":{"title":"Inference overview","icon":"brain","href":"/models"},"expanded":false,"pages":[{"title":"Amazon Bedrock","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/bedrock.svg","href":"/providers/inference/amazon-bedrock"},{"title":"Anthropic","icon":"https://api.iconify.design/simple-icons/anthropic.svg?color=currentColor","href":"/providers/inference/anthropic"},{"title":"Azure AI Foundry","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/azure.svg","href":"/providers/inference/azure-foundry"},{"title":"Azure OpenAI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/azure.svg","href":"/providers/inference/azure-openai"},{"title":"Baseten","icon":"https://unpkg.com/@lobehub/icons-static-svg@1.94.0/icons/baseten.svg","href":"/providers/inference/baseten"},{"title":"ChatGPT subscription","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/openai.svg","href":"/providers/inference/chatgpt"},{"title":"DeepSeek","icon":"https://unpkg.com/@lobehub/icons-static-svg@1.94.0/icons/deepseek.svg","href":"/providers/inference/deepseek"},{"title":"GitHub Copilot","icon":"https://api.iconify.design/simple-icons:githubcopilot.svg?color=currentColor","href":"/providers/inference/github-copilot"},{"title":"Google Gemini","icon":"https://unpkg.com/@lobehub/icons-static-svg@1.94.0/icons/gemini.svg","href":"/providers/inference/google-gemini"},{"title":"Kimi for Coding","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/kimi.svg","href":"/providers/inference/kimi-for-coding"},{"title":"LiteLLM","icon":"https://unpkg.com/@lobehub/icons-static-svg@1.94.0/icons/openai.svg","href":"/providers/inference/litellm"},{"title":"MiniMax","icon":"https://unpkg.com/@lobehub/icons-static-svg@1.94.0/icons/minimax.svg","href":"/providers/inference/minimax"},{"title":"Moonshot AI (Kimi)","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/moonshot.svg","href":"/providers/inference/moonshot-ai"},{"title":"Ollama","icon":"https://unpkg.com/@lobehub/icons-static-svg@1.94.0/icons/ollama.svg","href":"/providers/inference/ollama"},{"title":"OpenAI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/openai.svg","href":"/providers/inference/openai"},{"title":"OpenAI-compatible","icon":"https://unpkg.com/@lobehub/icons-static-svg@1.94.0/icons/openai.svg","href":"/providers/inference/openai-compatible"},{"title":"OpenCode Zen","icon":"https://api.iconify.design/simple-icons/opencode.svg?color=currentColor","href":"/providers/inference/opencode"},{"title":"OpenCode Go","icon":"https://api.iconify.design/simple-icons/opencode.svg?color=currentColor","href":"/providers/inference/opencode-go"},{"title":"OpenRouter","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/openrouter.svg","href":"/providers/inference/openrouter"},{"title":"Requesty","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/requesty.png","href":"/providers/inference/requesty"},{"title":"Together AI","icon":"https://unpkg.com/@lobehub/icons-static-svg@1.94.0/icons/together.svg","href":"/providers/inference/together-ai"},{"title":"TypeSafe","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/typesafe.svg","href":"/providers/inference/typesafe"},{"title":"Vercel AI Gateway","icon":"https://api.iconify.design/simple-icons/vercel.svg?color=currentColor","href":"/providers/inference/vercel-ai-gateway"},{"title":"vLLM","icon":"https://unpkg.com/@lobehub/icons-static-svg@1.94.0/icons/vllm.svg","href":"/providers/inference/vllm"},{"title":"xAI","icon":"https://unpkg.com/@lobehub/icons-static-svg@1.94.0/icons/xai.svg","href":"/providers/inference/xai"},{"title":"xAI Grok subscription","icon":"https://unpkg.com/@lobehub/icons-static-svg@1.94.0/icons/xai.svg","href":"/providers/inference/xai-subscription"},{"title":"Z.AI","icon":"https://unpkg.com/@lobehub/icons-static-svg@1.94.0/icons/zai.svg","href":"/providers/inference/zai"},{"title":"Z.AI Coding Plan","icon":"https://unpkg.com/@lobehub/icons-static-svg@1.94.0/icons/zai.svg","href":"/providers/inference/zai-coding-plan"}]},{"group":"Communications","icon":"messages-square","root":{"title":"Communications overview","icon":"messages-square","href":"/communications"},"expanded":false,"pages":[{"title":"Email (AgentMail)","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/agentmail.svg","href":"/providers/communications/agentmail"},{"title":"Discord","icon":"https://api.iconify.design/simple-icons:discord.svg?color=currentColor","href":"/providers/communications/discord"},{"title":"Microsoft Teams","icon":"https://api.iconify.design/simple-icons:microsoftteams.svg?color=currentColor","href":"/providers/communications/microsoft-teams"},{"title":"Slack","icon":"https://api.iconify.design/simple-icons:slack.svg?color=currentColor","href":"/providers/communications/slack"},{"title":"Telegram","icon":"https://api.iconify.design/simple-icons:telegram.svg?color=currentColor","href":"/providers/communications/telegram"}]},{"group":"Source control","icon":"git-merge","root":{"title":"Source control overview","icon":"git-merge","href":"/source-control"},"expanded":false,"pages":[{"title":"Azure DevOps","icon":"https://api.iconify.design/simple-icons:azuredevops.svg?color=currentColor","href":"/providers/source-control/azure-devops"},{"title":"Bitbucket Cloud","icon":"https://api.iconify.design/simple-icons:bitbucket.svg?color=currentColor","href":"/providers/source-control/bitbucket"},{"title":"Gitea","icon":"https://api.iconify.design/simple-icons:gitea.svg?color=currentColor","href":"/providers/source-control/gitea"},{"title":"GitHub","icon":"https://api.iconify.design/simple-icons:github.svg?color=currentColor","href":"/providers/source-control/github"},{"title":"GitLab","icon":"https://api.iconify.design/simple-icons:gitlab.svg?color=currentColor","href":"/providers/source-control/gitlab"}]},{"group":"Sandboxes","icon":"cpu","root":{"title":"Sandboxes overview","icon":"cpu","href":"/compute"},"expanded":false,"pages":[{"title":"Azure Container Apps","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/azure.svg","href":"/providers/compute/azure"},{"title":"Blaxel","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/blaxel.svg","href":"/providers/compute/blaxel"},{"title":"Box","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/box.svg","href":"/providers/compute/box"},{"title":"Daytona","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/daytona.svg","href":"/providers/compute/daytona"},{"title":"Docker","icon":"https://api.iconify.design/simple-icons:docker.svg?color=currentColor","href":"/providers/compute/docker"},{"title":"E2B","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/e2b.svg","href":"/providers/compute/e2b"},{"title":"Modal","icon":"https://api.iconify.design/simple-icons:modal.svg?color=currentColor","href":"/providers/compute/modal"}]}]},{"group":"Integrations","pages":[{"title":"Integrations overview","icon":"plug","href":"/integrations/index"},{"title":"Custom MCP servers","icon":"plug-zap","href":"/integrations/custom-mcp-servers"},{"title":"HTTP Integrations","icon":"arrow-right-left","href":"/integrations/http-integrations"},{"title":"Roomote MCP","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/favicon.svg","href":"/integrations/roomote-mcp"},{"title":"Asana","icon":"https://api.iconify.design/simple-icons:asana.svg?color=currentColor","href":"/integrations/asana"},{"title":"Better Stack","icon":"https://api.iconify.design/simple-icons:betterstack.svg?color=currentColor","href":"/integrations/better-stack"},{"title":"Buildkite","icon":"https://api.iconify.design/simple-icons:buildkite.svg?color=currentColor","href":"/integrations/buildkite"},{"title":"Braintrust","icon":"https://api.iconify.design/simple-icons:braintrust.svg?color=currentColor","href":"/integrations/braintrust"},{"title":"Cloudflare","icon":"https://api.iconify.design/simple-icons:cloudflare.svg?color=currentColor","href":"/integrations/cloudflare"},{"title":"ElevenLabs","icon":"https://api.iconify.design/simple-icons:elevenlabs.svg?color=currentColor","href":"/integrations/elevenlabs"},{"title":"Exa","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/exa.svg","href":"/integrations/exa"},{"title":"Grafana","icon":"https://api.iconify.design/simple-icons:grafana.svg?color=currentColor","href":"/integrations/grafana"},{"title":"Granola","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/granola.svg","href":"/integrations/granola"},{"title":"Jira","icon":"https://api.iconify.design/simple-icons:jira.svg?color=currentColor","href":"/integrations/jira"},{"title":"Linear","icon":"https://api.iconify.design/simple-icons:linear.svg?color=currentColor","href":"/integrations/linear"},{"title":"monday.com","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/monday.svg","href":"/integrations/monday"},{"title":"Neon","icon":"https://api.iconify.design/simple-icons:neon.svg?color=currentColor","href":"/integrations/neon"},{"title":"Notion","icon":"https://api.iconify.design/simple-icons:notion.svg?color=currentColor","href":"/integrations/notion"},{"title":"PostHog","icon":"https://api.iconify.design/simple-icons:posthog.svg?color=currentColor","href":"/integrations/posthog"},{"title":"Pylon","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/pylon.svg","href":"/integrations/pylon"},{"title":"Railway","icon":"https://api.iconify.design/simple-icons:railway.svg?color=currentColor","href":"/integrations/railway"},{"title":"Resend","icon":"https://api.iconify.design/simple-icons:resend.svg?color=currentColor","href":"/integrations/resend"},{"title":"Rippling","icon":"users","href":"/integrations/rippling"},{"title":"Sentry","icon":"https://api.iconify.design/simple-icons:sentry.svg?color=currentColor","href":"/integrations/sentry"},{"title":"Snowflake","icon":"https://api.iconify.design/simple-icons:snowflake.svg?color=currentColor","href":"/integrations/snowflake"},{"title":"Supabase","icon":"https://api.iconify.design/simple-icons:supabase.svg?color=currentColor","href":"/integrations/supabase"},{"title":"Supermemory","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/supermemory.svg","href":"/integrations/supermemory"},{"title":"Vercel","icon":"https://api.iconify.design/simple-icons:vercel.svg?color=currentColor","href":"/integrations/vercel"},{"title":"Voice","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/voice.svg","href":"/integrations/voice"},{"title":"X","icon":"https://api.iconify.design/simple-icons:x.svg?color=currentColor","href":"/integrations/x"},{"title":"Zero","icon":"https://mintlify.s3.us-west-1.amazonaws.com/roocode/logo/integrations/zero.svg","href":"/integrations/zero"}]},{"group":"Configuring Roomote","pages":[{"title":"Agent guidance","icon":"scroll-text","href":"/agent-guidance"},{"title":"Environment variables","icon":"variable","href":"/environment-variables"},{"title":"Environments","icon":"boxes","href":"/environments"},{"title":"Environment definition","icon":"file-code","href":"/environments/definition"},{"title":"Personal settings","icon":"user-cog","href":"/personal-settings"},{"title":"Skills","icon":"sparkles","href":"/skills"},{"title":"Users","icon":"users","href":"/users"}]},{"group":"Analytics","pages":[{"title":"Cost analytics","icon":"circle-dollar-sign","href":"/cost-analytics"}]},{"group":"Development","pages":[{"title":"Local development","icon":"terminal","href":"/local-development"},{"title":"How a Roomote deployment runs","icon":"network","href":"/architecture"}]}]},"basePath":"","title":"Operate a self-hosted deployment - Roomote Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}