Environment Variables

These environment variables control Recyclarr's behavior across all commands.

Looking for config substitution?

To substitute environment variable values into your YAML configuration files, see Value Substitution.

RECYCLARR_CONFIG_DIR

Overrides the default configuration directory location. This directory holds user configuration and state that should be backed up. See File Structure for platform defaults and directory contents.

export RECYCLARR_CONFIG_DIR="/custom/path/to/config"

RECYCLARR_DATA_DIR

Overrides the location for ephemeral data directory used for regenerable files like downloaded resources and logs.

export RECYCLARR_DATA_DIR="/custom/path/to/data"

If unset, defaults to the same path as RECYCLARR_CONFIG_DIR. When both variables are set, only the config directory needs to be backed up.

Relative paths are resolved from the config directory.

NO_COLOR

Disables ANSI color output when set to any non-empty value.

export NO_COLOR=1

Useful for scripting, piping output to files, or terminals that don't support colors.

See no-color.org for more information about this standard convention.