﻿RunWisp reads one file, `runwisp.toml`. It defines everything that runs; the
Web UI and REST API can trigger runs but never change the config. After an
edit, run [`runwisp reload`](/operations/reload/).

```toml title="runwisp.toml"
[defaults]
timeout = "1h"

[tasks.backup-db]
cron = "0 3 * * *"
run  = "pg_dump app | gzip > /backups/app.sql.gz"

[services.worker]
instances = 2
run       = "node worker.js"

[notifiers.slack-ops]
type        = "slack"
webhook_url = "${SLACK_URL}"
```

| Table                                           | What it holds                                                    |
| ----------------------------------------------- | ---------------------------------------------------------------- |
| [`[tasks.<name>]`](/configuration/tasks/)       | Commands that run on a schedule or by hand, then exit.           |
| [`[services.<name>]`](/configuration/services/) | Long-running processes RunWisp keeps alive.                      |
| [`[compose.<alias>]`](/configuration/compose/)  | Services imported from a `docker-compose.yml`.                   |
| [`[defaults]`](/configuration/defaults/)        | Fallback values for every task and service.                      |
| [`[daemon]`](/configuration/daemon/)            | Daemon-wide settings: timezone, TLS, metrics, included files.    |
| [`[storage]`](/configuration/storage/)          | Disk limits for run logs.                                        |
| [`[notify]`](/configuration/notify/)            | Daemon-wide notification settings.                               |
| [`[[route]]`](/configuration/routes/)           | Rules that send run events to notifiers.                         |
| `[notifiers.<id>]`                              | One outbound channel each. See [Notifications](/notifications/). |

Any string value can read an environment variable or a file with
[`${VAR}` or `${file:path}`](/configuration/substitution/).

The config path, data directory, and listen address are
[command-line flags](/reference/cli/#global-options),
not config keys.

## Editor support and validation

Start the file with a `#:schema` line and editors with TOML support (Even Better
TOML, taplo) autocomplete and check it as you type. Files RunWisp creates
already have it.

```toml title="runwisp.toml"
#:schema https://docs.runwisp.com/config.schema.json
# ...
```

```bash
runwisp validate   # check runwisp.toml exactly like daemon startup does
runwisp schema     # print the JSON Schema
```
