MATERIA-CONFIG-SERVER

Author

stryan

Published

June 1, 2026

Name

materia-config-server - Materia server mode configuration settings

Synopsis

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

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.