MATERIA-CONFIG-EXECUTOR

Author

stryan

Published

August 1, 2026

Name

materia-config-executor - Materia executor configuration settings

Synopsis

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

Description

The executor is the part of Materia that actually performs actions such as creating/updating/removing files and starting services.

These settings can be used to tweak its behavior.

Options

Presented in environmental variable/TOML config line option format.

MATERIA_EXECUTOR__CLEANUP_COMPONENTS/executor.cleanup_components

Defaults to false.

If an error occurs while installing a component resulting in an execution failure, purge the failed component.

MATERIA_EXECUTOR__MATERIA_DIR/executor.materia_dir

Overrides the executor’s configured materia data directory.

MATERIA_EXECUTOR__QUADLET_DIR/executor.quadlet_dir

Overrides the executor’s configured quadlet directory.

MATERIA_EXECUTOR__SCRIPTS_DIR/executor.scripts_dir

Overrides the executor’s configured scripts directory.

MATERIA_EXECUTOR__SERVICE_DIR/executor.service_dir

Overrides the executor’s configured service directory.

MATERIA_EXECUTOR__OUTPUT_DIR/executor.output_dir

Overrides the executor’s configured output directory.