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
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
One directory per stack, with its compose file inside.
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
Deployed-compose backups and database dumps, one directory per stack (mode 0700).
config_repo
The config repo seawall cloud init makes: a private git repo each capture commits to.
ignore
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
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
The Portainer container seawall talks to.
port
Portainer's HTTP port inside its container.
token
Token file, mode 0600. Empty: portainer-token beside this file, or ~/.config/portainer/api-token on older hosts.
environment
The Portainer environment new stacks go to, by name. Unset: the one on this host's Docker socket.
url
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
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
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
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
Other networks no stack may own (they must be declared external: true).
[monitoring]
stack
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
The network seawall reaches Prometheus and Grafana on.
prometheus
The Prometheus container. The graphs and the update reports come from it.
prometheus_port
Prometheus's port inside its container.
grafana
The Grafana container. Alerts and silences come from it.
grafana_port
Grafana's port inside its container.
grafana_url
Grafana's public address. With it, seawall alerts links each alert to its logs.
packs
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
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
The CrowdSec container seawall crowdsec runs cscli in.
allowlist
The allowlist seawall crowdsec allow adds to.
api
CrowdSec's local API, for the Security tab's bans. Unset: found from the container.
[logging]
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
Loki's port inside its container.
retention_days
How many days Loki keeps logs: 7 to 365.
ssh_from
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
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
When a daily finding (a critical image update, labelled page=daily) may page, in this host's time zone. seawall init applies a change.
doc_links
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
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
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
Snapshots kept for each stack: the newest of each of this many days,
keep_weekly
of this many weeks,
keep_monthly
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
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
Where each capture is pushed, with the deploy key init makes; unset, the repo stays here.
branch
The branch it pushes to.
host_files
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
The reverse proxy: npm, traefik, caddy, swag, cloudflared or none.
container
Its container: routes are read through it, and certificates are checked at its port 443.
[npm]
database
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
Proxy hosts under this domain front MCP servers and get the MCP checks.
letsencrypt_email
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
The vendor's LTS tag: the major update offered is the version it points to.
hold_major
Stay on this major, and why. The check still shows the newer major as held.
release_suffix
A word such as security: X.Y.Z-security-N counts as a release of X.Y.Z.
ignore
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
Known-good versions kept per service. 0 keeps none: a rollback pulls by tag.
[facts]
expected_ports
Host ports a container may publish on an address other than loopback.
expected_privileged
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
Each stack runs as its own user, seawall-<stack>, with a uid and group from this range.
last
The last uid a stack's user gets. init checks the range against the ids the host uses.
owner
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
The zone the times are in: UTC, local (the host's own zone) or one such as Europe/London.
db_backup
The database dumps, each restore-tested.
data_backup
The data backups, after the dumps.
capture
The config capture.
drift
The drift check: the host's live config against the last capture (not a restore check).
crowdsec_hub
CrowdSec's hub items kept current.
updates
The image update check.
[tui]
The command centre (seawall tui) and the CLI's colours.
[tui]
ground = "auto"
mouse = true
ground
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
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.