Skip to main content

Auto-Updates

Tdarr has two separate update mechanisms:

  • The internal Server and Node auto-updater in the Tdarr WebUI.
  • The standalone Tdarr_Updater executable used by native installs.

These update mechanisms are independent. The auto-update settings on the Options tab only control the internal Server and Node updater; they do not configure, enable, disable, or schedule Tdarr_Updater.

Internal Server and Node auto-updater​

Tdarr's internal Server and Node auto-updater is available in version 2.56.01 and above. Configure it from the Tdarr WebUI Options tab.

Use the Changing Version page to select target versions with the internal updater widget.

As Docker images/containers are designed to be immutable (fixed), you need to set env enableDockerAutoUpdater=true to enable the auto-updater.

For Servers and Nodes running in Docker, it's recommended to use container managers such as Portainer, Watchtower or Ouroboros to auto-update rather than using the internal auto-updater, as the internal auto-updater won't apply any container-specific dependency or config changes

If running multiple Nodes on the same machine, make sure they have been created in a different directory, else 2 Nodes trying to auto-update at the same time may cause file conflicts. For example:

C:/Users/Bob/Documents/Tdarr1/Tdarr_Node/Tdarr_Node.exe
C:/Users/Bob/Documents/Tdarr2/Tdarr_Node/Tdarr_Node.exe

The internal auto-updater can also downgrade Server and Node versions by selecting an older version.

caution

The internal auto-updater may take some time to complete and any errors will be shown in the corresponding log for that module, i.e. ./logs/Tdarr_Server_Log.txt for Tdarr Server and ./logs/Tdarr_Node_Log.txt for Tdarr_Node

Standalone Tdarr_Updater executable​

Tdarr_Updater is an external updater used by native Windows, Linux, and macOS installs. It is run directly from the command line or by launching the executable, not from the WebUI auto-update settings.

For native installs, Tdarr_Updater target versions are controlled by configs/Tdarr_Updater_Config.json, such as the requiredVersion setting.

To use Tdarr_Updater, run the Tdarr_Updater executable directly.