Skip to content

Configuration

Every setting of the install, with its default, its range and its meaning.

Settings are one JSON object in ~/.skyworker/config.json. The file is optional. A key in the file replaces the default. skyworker init and skyworker upgrade apply the file to the Worker. Run skyworker upgrade after you change it.

{
  "idlePauseMinutes": 30,
  "instance": { "memoryMib": 8192 },
  "maxTaskCost": 5
}

A bad value fails with a Failed: line that names the key. ~/.skyworker/config.json that is not JSON, or not one object, fails with the same kind of line. The key notifyUrl is not a setting. The notify URL is a Worker secret. Use skyworker notify-url.

Size

instance sets the container size. The same size applies to every workspace of the install. Give an object, or a size name: lite or standard-1 to standard-4. In an object, a key that you leave out keeps its default.

Key Default Meaning
instance.vcpu 2 Virtual CPUs: 1, 2, 3 or 4.
instance.memoryMib 6144 Memory in MiB.
instance.diskMb 20000 Disk in MB.

Pause and limits

Key Default Range Meaning
maxRunning 10 1 to 100 The most workspaces that run at once.
maxAwakeHours 12 1 to 168 A workspace that is awake this long pauses, also while it works.
idlePauseMinutes 20 1 to 1440 Minutes with no use before a workspace pauses.
warmMinutes 10 0 to 1440 After a pause, the container stays warm this long. Zero stops it at once.
checkpointMinutes 0 0 to 1440 Zero is off. Above zero, a workspace with changes saves a snapshot without stopping after this many minutes.
snapshotRefreshDays 3 0 to 29 This many days before a snapshot expires, the Worker restores it briefly to start a new 30 days. Zero lets it expire.
inactivityTimeoutMinutes 15 1 to 1440 The inactivity timeout of the platform for a container.
alarmSeconds 60 10 to 3600 The interval of the alarm that keeps a workspace awake. It must be shorter than inactivityTimeoutMinutes.
serverPort 4096 1 to 65535 The port of opencode serve in the container. Port 4097 is the port of the bridge and fails.
projectSnapshotRefresh "off" "off" or "on-change" Accepts only these two values.

Long tasks

Key Default Range Meaning
autoContinue 3 0 to 20 Automatic continues of a task after a stop that no person asked for. run --continues sets it for one task.
maxTaskHours 24 1 to 720 The time budget of a task in hours of work. run --max-hours sets it for one task.
maxTaskCost 0 0 to 10000 The cost budget of a task in dollars. Zero is off. run --max-cost sets it for one task.
stallMinutes 30 0 to 1440 A working task with no change for this long gives one stall notice. Zero is off.
progressNoteHours 6 0 to 168 One progress note for each this many hours of work. Zero is off.
cpuShare 0.25 0 to 1 The share of the provisioned vCPU that the cost estimate counts as busy.
autoReply true true or false Send one automatic reply to a handed-off session that ends its turn with commits that are not pushed or processes left running.

Models and network

Key Default Meaning
ai true Models through the AI binding of the Worker. Off: OpenCode keeps only its own providers.
model cloudflare-workers-ai/@cf/zai-org/glm-5.3 The default model of OpenCode, as provider/model. Empty: OpenCode chooses.
aiGateway "default" The AI Gateway that the binding uses.
searchProvider "exa" The provider of web search from a workspace. The Worker source names exa, linkup and ceramic.
lockdown false True: a workspace has no general internet. Only the provider hosts whose secret is set resolve.

Features

Key Default Meaning
store false Add an R2 bucket for files that outlive a workspace. init and upgrade make it. See skyworker store.
a2a false Serve the Agent2Agent Agent Card and endpoint on the Worker. It is one more way to run code.
images {} Extra image references, as an object.

Files in ~/.skyworker

Path Content
install.json The Worker URL, name, account, Custom Domain and web client URL.
control-token The control token. Mode 600.
config.json The settings above.
workspaces/<id>.json What this machine knows of one workspace.
workspaces/<id>.password The workspace password. Mode 600.
ssh/id_ed25519 The SSH key of this machine for workspaces.
ssh/known_hosts The host keys of workspaces.
deploy/ and deploy.log The copy of the sources of the last deploy, and its log.
license-key The licence key. Mode 600.
builds/<version> A build that the installer downloaded.

Type to search…

↑↓ navigate↵ selectEsc close