Skip to main content

Authentication

To enable authentication, set the Tdarr Server env/config auth variable to true.

A random authSecretKey will automatically be generated when Tdarr starts up, but you can also set it manually as an env/config variable.

Once Tdarr starts up, you'll be prompted to set a username and password in the web UI.

After you sign in you'll need to head to the Tools -> API Keys page and create an API key for your Nodes to use.

You'll then need to set the apiKey env/config var on your Nodes so they can connect to your server.

Automatic API Key Creation​

For automated deployments, you can use the seededApiKey environment variable to automatically create an API key when the server starts up. This is particularly useful for Docker deployments or automated setups where you want to ensure a specific API key exists without manual intervention.

Requirements:

  • The API key must start with tapi_
  • The API key must be at least 14 characters long (including tapi_)
  • If the API key already exists, it will not be recreated

Example:

export seededApiKey=tapi_my_secure_api_key_123

Docker example:

docker run -ti \
    -e "auth=true" \
    -e "seededApiKey=tapi_my_secure_api_key_123" \
    ghcr.io/haveagitgat/tdarr