Skip to main content

The documentation here is for an unreleased version of Recyclarr.

Visit the documentation site for the Current Version instead.

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.