Settings

seawall reads ~/.config/seawall/seawall.toml, or the file SEAWALL_CONFIG names. seawall init writes it. Every key is optional. An unknown key is an error.

seawall config opens the settings screen and seawall config --print prints every value in force as TOML. seawall doctor checks the file and its permissions.

The settings screen

Enter edits the row you're on and s saves. Saving writes the file and nothing else.

A container row (Portainer, Prometheus, Grafana, CrowdSec and the proxy) lists the running containers. Pick one with the arrow keys and press Enter, or press t to type a name.

Three rows do their own setup. Folders makes the stacks and backups folders when they're missing. Allowlist in CrowdSec makes CrowdSec's allowlist. CrowdSec API turns the read-only bouncer on or off. Enter shows what the row will do and y does it. Folders and Allowlist in CrowdSec say so when there is nothing to make. These rows use the values on the screen, saved or not.

The token row takes Portainer's API token. Make one in Portainer under My account, Access tokens, Add access token. seawall keeps it in the token file (mode 0600) and never shows it.

[host]

name

String. Optional. Example "homelab".

Shown in status, the login banner, the menu and the TUI. Default: the hostname.

[runtime]

The account a rootless runtime runs as, owning nothing else: access to its socket is all its power. Unset: a rootless runtime is seawall's own user's. Who may use its socket, through the group <owner>-access: each member has the runtime user's power over every container it runs, and facts flag anyone else in the group.

[runtime]
owner = "seawall-rt"
access = ["you"]

[paths]

stacks

String. Default "~/docker".

One directory per stack, with its compose file inside.

games

String. Default "games".

One folder per game server, inside stacks: a path, or just the folder's name. Init sets it to the folder an earlier seawall made, where a host has that one and no games folder.

backups

String. Default "~/backups".

Deployed-compose backups and database dumps, one directory per stack (mode 0700).

config_repo

String. Optional. Example "~/repos/host-config".

The config repo seawall cloud init makes: a private git repo each capture commits to.

ignore

Array. Optional. Example ["projects/old-thing"].

Folders seawall leaves alone: never a stack, a stray, swept or linted. Relative to stacks, or a full path (~/tmp) outside it; * matches within a folder's name. seawall stray ignore FOLDER adds one.

[games]

prefix

String. Default "server-".

What a game's stack name starts with: the folder games/vikings/ is the stack server-vikings. Empty: the folder's name alone.

[portainer]

container

String. Default "portainer".

The Portainer container seawall talks to.

port

Integer. Default 9000.

Portainer's HTTP port inside its container.

token

String. Default "".

Token file, mode 0600. Empty: portainer-token beside this file, or ~/.config/portainer/api-token on older hosts.

environment

String. Optional. Example "local".

The Portainer environment new stacks go to, by name. Unset: the one on this host's Docker socket.

url

String. Optional. Example "https://portainer.example.org".

Portainer's public address. seawall init routes it through the proxy, letting in only the addresses in allow: Portainer is root on this host.

allow

Array. Optional. Example ["203.0.113.7", "198.51.100.0/24"].

The addresses Portainer's route lets in, IPs or CIDR ranges: a public range at most /16 (IPv4) or /48 (IPv6), a private one (10/8, 172.16/12, 192.168/16, fc00::/7) whole. More than one /16 or /48 in all is typed to confirm. Without them, no route is made.

[manager]

default

String. Default "portainer".

What runs the stacks: portainer, or compose (each stack from its own folder).

[manager.stacks]

Stacks run by the other one, by name.

[manager.stacks]
npm = "compose"

[networks]

ingress

String. Default "proxy".

The reverse proxy reaches backends over this network. Lint keeps databases and published ports off it, and the wizard puts web apps on it.

external

Array. Default [].

Other networks no stack may own (they must be declared external: true).

[monitoring]

stack

String. Optional. Example "seawall-monitoring".

The stack Prometheus and Grafana run in. Unset: the one seawall init wrote, seawall-monitoring (monitoring on a host set up before that name).

network

String. Default "monitoring".

The network seawall reaches Prometheus and Grafana on.

prometheus

String. Default "prometheus".

The Prometheus container. The graphs and the update reports come from it.

prometheus_port

Integer. Default 9090.

Prometheus's port inside its container.

grafana

String. Default "grafana".

The Grafana container. Alerts and silences come from it.

grafana_port

Integer. Default 3000.

Grafana's port inside its container.

grafana_url

String. Optional. Example "https://grafana.example.org".

Grafana's public address. With it, seawall alerts links each alert to its logs.

packs

Array. Optional. Example ["host", "health", "updates", "backups"].

The alert rule packs seawall's own monitoring keeps: host, health, updates, backups, logs, audit and probes. Unset: every one. seawall init applies a change, deleting an off pack's rules.

probes

Array. Optional. Example ["blog.example.org"].

The public hosts seawall's blackbox exporter probes, as a visitor reaches them. Set with seawall proxy probes add, which also writes Prometheus's targets.

[crowdsec]

container

String. Default "crowdsec".

The CrowdSec container seawall crowdsec runs cscli in.

allowlist

String. Default "seawall".

The allowlist seawall crowdsec allow adds to.

api

String. Optional. Example "http://127.0.0.1:8080".

CrowdSec's local API, for the Security tab's bans. Unset: found from the container.

[logging]

loki

String. Default "loki".

The Loki container, on the monitoring network. seawall init runs it in the logging stack, with Alloy, which sends it the host's and the containers' logs.

loki_port

Integer. Default 3100.

Loki's port inside its container.

retention_days

Integer. Default 30.

How many days Loki keeps logs: 7 to 365.

ssh_from

Array. Optional. Example ["198.51.100.7", "2001:db8:1:2::/64"].

Where SSH logins are expected from: your addresses and any automation's, each an address or a network. A login from anywhere else pages at sev0. Unset, that alert isn't written.

login_paths

Table. Optional. Example { "/login" = "401|429", "/ghost/api/admin/session/?" = "404|422|429" }.

The admin logins behind the proxy whose failed POSTs count towards AdminLoginBruteForce: each path (a regular expression, matched whole) and the statuses a failure gets. Grafana's and Ghost's unless set.

[notifications]

page_hours

String. Default "08:00-23:59".

When a daily finding (a critical image update, labelled page=daily) may page, in this host's time zone. seawall init applies a change.

Boolean. Default true.

Whether each alert's notification links its page on seawall.sh, by the alert's name alone (Grafana's runbook_url). seawall init applies a change.

[notifications.smtp]

The mail server email destinations go through, set in seawall config when Pages or Rollup is email.

[notifications.smtp]
host = "smtp.example.org:587"
user = "[email protected]"
from = "[email protected]"
plain = true

plain

Boolean. Example true.

STARTTLS is required, so the password never crosses in clear (port 465 is TLS from the start). plain = true sends in clear when the server offers no TLS: only for a relay on this host or a network you trust.

[backup]

destination

String. Optional. Example "/mnt/backup/seawall".

Where restic keeps the data backups. A local folder made for root alone, or an S3 bucket as s3:https://<endpoint>/<bucket>[/<path>]. Set by seawall backup setup --to.

keep_daily

Integer. Optional. Example 7.

Snapshots kept for each stack: the newest of each of this many days,

keep_weekly

Integer. Optional. Example 4.

of this many weeks,

keep_monthly

Integer. Optional. Example 6.

and of this many months.

[backup.stacks]

How each stack is read: "pause" (the default: its containers frozen while restic reads, then unpaused), "live", "stop" (stopped and started again, its alerts silenced meanwhile) or "exclude".

[backup.stacks]
nextcloud = "stop"

[cloud]

recipient

String. Optional. Example "age1...".

The config backup seawall keeps itself, in the git repo at paths.config_repo that seawall cloud init makes. Each secret is sealed to this age public key; the key that opens them stays with you, never on this host.

remote

String. Optional. Example "[email protected]:you/host-config.git".

Where each capture is pushed, with the deploy key init makes; unset, the repo stays here.

branch

String. Optional. Example "main".

The branch it pushes to.

host_files

Array. Optional. Example ["/etc/docker/daemon.json", "/etc/ufw/user.rules", "/etc/systemd/system/seawall-*"].

The host files each capture takes, each in a folder under /etc (a trailing * is every file whose name starts so). Unset: the files seawall writes there. Files only root can read come through the facts root unit's copy; seawall init --only facts applies a change. Folders that hold keys or passwords (ssh, ssl, sudoers.d and the like) are never taken.

[proxy]

kind

String. Default "npm".

The reverse proxy: npm, traefik, caddy, swag, cloudflared or none.

container

String. Default "npm".

Its container: routes are read through it, and certificates are checked at its port 443.

[npm]

database

String. Default "".

Nginx Proxy Manager's SQLite database, opened read-only. Relative to paths.stacks. Empty: database.sqlite in the folder NPM's container mounts at /data.

mcp_domain

String. Optional. Example "mcp.example.org".

Proxy hosts under this domain front MCP servers and get the MCP checks.

letsencrypt_email

String. Optional. Example "[email protected]".

The email Let's Encrypt writes to about the certificates seawall proxy route add asks NPM for, on NPM before 2.16 (since, NPM uses its own user's email). Asked once and kept here; not a secret.

[stacks]

Stack name = directory under paths.stacks, for a stack whose directory isn't named after it. Every other directory with a compose file is the stack of the same name (nextcloud/ is nextcloud), and a game's folder games/vikings/ is server-vikings.

[stacks]
my-cloud = "nextcloud"

[updates.images.mysql]

The daily image update check. Rules for one image are keyed by its repository (mysql, grafana/grafana, ghcr.io/owner/name).

[updates.images.mysql]
lts_tag = "lts"
hold_major = { major = 8, reason = "the app supports MySQL 8 only" }
release_suffix = "security"
ignore = true

lts_tag

String. Example "lts".

The vendor's LTS tag: the major update offered is the version it points to.

hold_major

Table. Example { major = 8, reason = "the app supports MySQL 8 only" }.

Stay on this major, and why. The check still shows the newer major as held.

release_suffix

String. Example "security".

A word such as security: X.Y.Z-security-N counts as a release of X.Y.Z.

ignore

Boolean. Example true.

Leave the image out of the check.

[updates.local_builds.my-app]

Images built on this host, by container name, with the base they are built from (the Dockerfile's FROM, with a tag). The check reports when the base has an update.

[updates.local_builds.my-app]
base = "node:24-alpine"

[[updates.ignore_cves]]

A CVE the scans leave out until a date, for every image or for one repository.

[[updates.ignore_cves]]
id = "CVE-2026-12345"
until = "2026-12-31"
reason = "not reachable: the vulnerable feature is off"
image = "mysql"

[images.cleanup]

Images on this host. host reclaim and images prune keep each service's last known-good image (the one it ran at its last deploy whose check passed) besides the one that runs, so a rollback starts without a pull.

[images.cleanup]
keep = 1

keep

Integer. Example 1.

Known-good versions kept per service. 0 keeps none: a rollback pulls by tag.

[facts]

expected_ports

Array. Optional. Example ["80/tcp", "443/tcp", "7777/udp"].

Host ports a container may publish on an address other than loopback.

expected_privileged

Array. Optional. Example ["cadvisor"].

Containers that may run privileged.

[[facts.accept_listeners]]

A program left listening that's expected. seawall accept listener writes these. address is loopback (127.0.0.0/8 and ::1) or one address, which then needs port.

[[facts.accept_listeners]]
process = "mcpd"
address = "loopback"
reason = "an MCP server, one per editor session"

[[facts.expected_firewall_rules]]

DOCKER-USER rules that must be present, as iptables -S prints them.

[[facts.expected_firewall_rules]]
name = "admin-drop"
rule = "-A DOCKER-USER -p tcp -m tcp --dport 81 -j DROP"

[run_users]

first

Integer. Default 20000.

Each stack runs as its own user, seawall-<stack>, with a uid and group from this range.

last

Integer. Default 20999.

The last uid a stack's user gets. init checks the range against the ids the host uses.

owner

String. Default "write".

What you may do in stack data, through each stack's group: read (folders 2750) or write (2770).

[run_users.stacks]

Stack -> its uid, written when a stack first gets one.

[run_users.stacks]
ghost = 20000

[init]

Steps seawall init leaves out on this host. A first init on a terminal writes what was left out; --only STEP still runs one. Names as seawall init --skip takes them.

[init]
skip = ["crowdsec"]

[timers]

When seawall's daily timers run, each a time of day (HH:MM). seawall init puts a change into their units.

zone

String. Default "UTC".

The zone the times are in: UTC, local (the host's own zone) or one such as Europe/London.

db_backup

String. Default "04:30".

The database dumps, each restore-tested.

data_backup

String. Default "04:45".

The data backups, after the dumps.

capture

String. Default "05:20".

The config capture.

drift

String. Default "17:20".

The drift check: the host's live config against the last capture (not a restore check).

crowdsec_hub

String. Default "05:40".

CrowdSec's hub items kept current.

updates

String. Default "06:00".

The image update check.

[tui]

The command centre (seawall tui) and the CLI's colours.

[tui]
ground = "auto"
mouse = true

ground

String. Example "auto".

The terminal's background: auto (the default), dark or light. auto reads COLORFGBG: A background of 7 or 15 is light, else dark. dark or light outranks COLORFGBG. On light, the command centre and the CLI draw in darker shades.

mouse

Boolean. Example true.

On (true, the default): A click picks a row or a tab, the wheel scrolls, and Shift and a drag select text in most terminals. Off (false): The mouse is the terminal's, and a drag selects text.