---
title: "Configuration"
description: "Every setting of the install, with its default, its range and its meaning."
---

> Documentation Index
> Fetch the complete documentation index at: https://skyworker.system3inference.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

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.

```json
{
  "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. |

Source: https://skyworker.system3inference.dev/docs/reference/configuration/index.mdx
