Skip to content

Environment Variables

Environment variables are OPTIONAL.

Here are the optional environment variables you can set:

APP_DATA_DIR

  • Default is /config.

This environment variable is used to set the application data directory. If setting this, make sure to map the volume to the same directory.

Useful if you want to store the application data in a different directory than the default.

For example, if you want to store the application data in /app_config/abc, you can set the APP_DATA_DIR environment variable like this:

    environment:
        - APP_DATA_DIR=/app_config/abc
    volumes:
        - /var/appdata/trailarr:/app_config/abc

Warning

If you are setting the APP_DATA_DIR environment variable, make sure to set an absolute path like /data or /config/abc, and map the volume to the same directory.

Danger

Do not set APP_DATA_DIR to /app or /tmp or any other linux system directory. This could cause the application to not work correctly or data loss.

PGID

  • Default is 1000.

This environment variable is used to set the group ID for the application.

Useful if you have permission issues with the application writing to the volume. You can set the group ID to the group of the volume or a group that has read/write permissions to the volume.

    environment:
        - PGID=1000

PUID

  • Default is 1000.

This environment variable is used to set the user ID for the application.

Useful if you have permission issues with the application writing to the volume. You can set the user ID to the owner of the volume or a user that has read/write permissions to the volume.

    environment:
        - PUID=1000

TZ

  • Default is America/New_York.

This environment variable is used to set the timezone for the application.

For a list of valid timezones, see tz database time zones.

    environment:
        - TZ=America/New_York

WEBUI_PASSWORD

  • Default is trailarr (hashed).

Trailarr Web Interface has a browser login to access the app. Default credentials are:

Username: admin
Password: trailarr

If you forget your password, set this environment variable to '' (empty string) to reset the password for the web interface to default.

To change the password, go to Settings > About > Password in web interface.

    environment:
        - WEBUI_PASSWORD='' # This will reset the password to default

Example

Here is an example of setting the environment variables:

    environment:
        - TZ=America/Los_Angeles
        - PUID=1000
        - PGID=1000
        - APP_DATA_DIR=/data/trailarr
    volumes:
        - /var/appdata/trailarr:/data/trailarr

This sets the environment variables to run the app with following settings:

  • Timezone: America/Los_Angeles
  • User ID: 1000
  • Group ID: 1000
  • Application data directory: /data/trailarr
  • Volume mapping: /var/appdata/trailarr:/data/trailarr