MATERIA-CONFIG-FILE

Author

stryan

Published

August 1, 2026

Name

materia-config-file - Materia configuration for file based attribute management

Synopsis

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

Description

Settings for file based attribute management.

If you don’t need any settings (i.e. you’re using the default vaults and base dir), you can enable the engine by setting MATERIA_FILE="" or adding an empty [file] table to your config.

Supports TOML files.

Options

MATERIA_FILE__BASE_DIR/file.base_dir

Directory that contains attributes. Defaults to secrets.

MATERIA_FILE__VAULTS/file.vaults

Files that are general attributes vaults. Defaults to vault.toml.

MATERIA_FILE__LOAD_ALL_VAULTS/file.load_all_vaults

Whether to load all vault files that exist without filtering by role, or filename above. Defaults to false.

File Format

A file vault is a TOML file with one or more of the following tables:

[globals]: Global attributes [hosts]: Attributes scoped to a host [components]: Attributes scoped to a component [roles]: Attributes scoped to a role

An example file would look like this:

[components]
[components.freshrss]
dataContents = ""
extensionsContents = ""
port = "7770"
containerTag = "edge"