MATERIA-CONFIG-SERVER

Author

stryan

Published

August 1, 2026

Name

materia-config-server - Materia server mode configuration settings

Synopsis

/etc/materia/config.toml, $MATERIA_SERVER__<option-name>

Description

Settings that only apply to Materia when run in server mode (with materia server).

Options

MATERIA_SERVER__UPDATE_INTERVAL/server.update_interval

How long (in seconds) for materia server to wait before running a materia update.

MATERIA_SERVER__PLAN_INTERVAL/server.plan_interval

How long (in seconds) for materia server to wait before running a materia plan.

MATERIA_SERVER__NOTIFY_WEBHOOK/server.notify_webhook

Where to send webhook notifications on plan/update failure.

This has been replaced by the materia-config-notify.5 config.

MATERIA_SERVER__UPDATE_WEBHOOK/server.update_webhook

True/false. Whether to enable the HTTP /webhook listener. Accepts POST’ed JSON payloads in the following format:

{
    "revision": "optional: revision to sync to",
    "update": true|false,
    "secret": "pre-shared secret: server.secret"
}

MATERIA_SERVER__UPDATE_SECRET/server.update_secret

Pre-shared secret for basic security on update webhook

MATERIA_SERVER__UPDATE_URL/server.update_url

What URL the update webhook listens on. Defaults to :6284/webhook

MATERIA_SERVER__SOCKET/server.socket

What Unix socket to listen on for the Varlink API.

Defaults to unix:/run/materia/materia.sock for root and unix:/run/UID/materia/materia.sock for rootless.