Skip to main content

Changing Version

Use this page when you want to upgrade, downgrade, or install a specific Tdarr version.

For native Windows, Linux, and macOS installs, the WebUI updater can upgrade or downgrade the Server and Nodes. For Docker installs, change the image tag used by your container manager. If you need direct Server or Node packages, use the helper below to generate platform-specific download links.

Server and Node
Target version

Stable releases use the format 2.81.01.
Loading latest release from https://storage.tdarr.io/versions.json.

Use the WebUI updater

  1. Open http://server-ip:8265/#/options/ and go to the Updates section.
  2. Select 2.81.01 from the version dropdown.
  3. Enable Auto update non-Docker server for the Server.
  4. Enable Auto update/downgrade non-Docker nodes for Nodes.
  5. Click Check For Update, then wait for Relaunch with 2.81.01 to appear and click it when ready.

Download manually

Stop the matching process, unzip the package next to your current Tdarr_Server or Tdarr_Node folder (or replace the existing folder), then start it.

Docker and Flatpak

Stable Docker imagesghcr.io/haveagitgat/tdarr:2.81.01ghcr.io/haveagitgat/tdarr_node:2.81.01

For Docker self-updating, set enableDockerAutoUpdater=true on the container. The self-updater is not supported in Flatpak.

Which Method Should I Use?​

Native Windows, Linux, and macOS installs​

For native installs, use the Tdarr WebUI:

  1. Open the Tdarr WebUI.
  2. Go to Options.
  3. In the Updates section, choose the version you want.
  4. Enable Auto update non-Docker server, Auto update/downgrade non-Docker nodes, or both.
  5. Click Check For Update, then relaunch when Tdarr offers the selected version.

The WebUI updater handles both upgrades and downgrades for the Tdarr Server and Nodes. See Auto-Updates for more detail about how the internal updater works.

info

Tdarr_Updater is a separate executable. The auto-update settings in the WebUI do not configure or schedule Tdarr_Updater.

Docker installs​

For Docker, change the image tag in your docker run command, Compose file, Portainer stack, or other container manager, then apply the change using that manager.

Stable Server and Node images:

ghcr.io/haveagitgat/tdarr:latest
ghcr.io/haveagitgat/tdarr_node:latest
ghcr.io/haveagitgat/tdarr:{version}
ghcr.io/haveagitgat/tdarr_node:{version}

Replace {version} with the version you want.

Docker images and containers are designed to be immutable. To use Tdarr's internal Docker updater, set enableDockerAutoUpdater=true on the container. The internal Docker updater is not supported in Flatpak.

Manual native downloads​

Use manual downloads when you cannot use the WebUI updater, are preparing a new install, or need to place Server and Node packages yourself.

  1. Enter the release version or dev tag in the helper above.
  2. Download the matching Tdarr_Server and Tdarr_Node packages for your operating system and CPU architecture.
  3. Stop the Tdarr Server or Node you are replacing.
  4. Unzip the package next to the current folder, or replace the existing folder.
  5. Start Tdarr again.

All release packages are also listed in versions.json.

Pre-Releases And Dev Builds​

Pre-release builds are published before they become the normal latest Docker image or native package. Dev tags use the format shown below.

Native installs​

In the WebUI updater, switch to manual entry and paste the dev tag. Dev tags look like this:

dev_2.82.01_2026_06_27T13_01_36z

The helper above can turn that dev tag into direct download links for each platform.

If you are using the standalone Tdarr_Updater executable instead of the WebUI, edit configs/Tdarr_Updater_Config.json, set requiredVersion for the Server and Node, save the file, then run Tdarr_Updater. Only the relevant fields are shown below:

{
  "modules": {
    "Tdarr_Node": {
      "requiredVersion": "<target-version>"
    },
    "Tdarr_Server": {
      "requiredVersion": "<target-version>"
    }
  }
}

Docker pre-releases​

Pre-release Docker images use the acceptance image names:

ghcr.io/haveagitgat/tdarr_acc:dev
ghcr.io/haveagitgat/tdarr_node_acc:dev
ghcr.io/haveagitgat/tdarr_acc:{version}
ghcr.io/haveagitgat/tdarr_node_acc:{version}

Use {version} when you want a specific pre-release version.

Image Reference​

The equivalent docker.io images are also available.

Stable images​

ghcr.io/haveagitgat/tdarr:latest
ghcr.io/haveagitgat/tdarr:{version}
ghcr.io/haveagitgat/tdarr_node:latest
ghcr.io/haveagitgat/tdarr_node:{version}
docker.io/haveagitgat/tdarr:latest
docker.io/haveagitgat/tdarr:{version}
docker.io/haveagitgat/tdarr_node:latest
docker.io/haveagitgat/tdarr_node:{version}

Pre-release images​

ghcr.io/haveagitgat/tdarr_acc:dev
ghcr.io/haveagitgat/tdarr_acc:latest
ghcr.io/haveagitgat/tdarr_acc:{version}
ghcr.io/haveagitgat/tdarr_node_acc:dev
ghcr.io/haveagitgat/tdarr_node_acc:latest
ghcr.io/haveagitgat/tdarr_node_acc:{version}
docker.io/haveagitgat/tdarr_acc:dev
docker.io/haveagitgat/tdarr_acc:latest
docker.io/haveagitgat/tdarr_acc:{version}
docker.io/haveagitgat/tdarr_node_acc:dev
docker.io/haveagitgat/tdarr_node_acc:latest
docker.io/haveagitgat/tdarr_node_acc:{version}