Skip to content

Configuration

Fedinesia is configured through environment variables. When run as a CLI tool the wizard writes a config.json file; when run as a container all settings are passed via environment variables.

Environment Variables

PAUSE_IN_SECONDS (mandatory in container mode)

Number of seconds to wait between successive runs of fedinesia. Must be a positive integer.

PAUSE_IN_SECONDS=300

AUDIT_LOG_FILE (optional)

Full path to the audit log file. If unset, no audit log is written.

In container deployments, write to the /logging directory so the file is accessible via a volume mount.

AUDIT_LOG_FILE=/logging/audit.log

AUDIT_STYLE (optional)

Format for the audit log. Accepted values: PLAIN (default) or CSV. Has no effect when AUDIT_LOG_FILE is not set.

AUDIT_STYLE=CSV

LIMIT (optional)

Stop processing after this many deletions in a single execution. Useful for rate-sensitive instances or for spreading deletions across runs.

LIMIT=100

DRY_RUN (optional)

When set to any non-empty value fedinesia logs which statuses would be deleted without actually deleting them. Recommended for testing your configuration before a live run.

DRY_RUN=true

PROGRESS_FILE (optional)

Path to a file where fedinesia stores progress between executions. Enables resumable deletion across multiple runs. Intended for use with CONTINUE_PROGRESS.

PROGRESS_FILE=/logging/progress.json

CONTINUE_PROGRESS (optional)

When set to any non-empty value, fedinesia resumes from the last successfully deleted status (in reverse chronological order). Requires PROGRESS_FILE to be set.

CONTINUE_PROGRESS=true

LOGGING_CONFIG (optional)

Path to a TOML file containing Loguru handler configuration. If unset, fedinesia uses its built-in defaults.

LOGGING_CONFIG=/config/logging.toml

Example logging config file:

[[handlers]]
sink = "sys.stdout"
format = "{message}"
level = "INFO"

[[handlers]]
sink = "/logging/fedinesia-debug.log"
rotation = "1 day"
retention = 3
level = "DEBUG"
format = "{time} - {level} - {name} - {function}({line}) - {message}"
colorize = "none"