Tdarr: Install
Add Tdarr from Starboard's Catalogue, where it is listed under Apps you can add. Starboard shows what it may do and tests it before anything is added. At the end, Tdarr is active, with its own page on your home network.
Before you begin
- Starboard with plug-in API 1.14 or later. An older Starboard is offered an earlier version: read Updates.
- Your Starboard password. Adding and removing a plug-in ask for it.
- If the main install already runs Tdarr: bring it in before you activate the plug-in, so its libraries, flows and history carry over. Read Set it up.
What it may do
Starboard lists these before you add it, each with its risk.
| Permission | Risk |
|---|---|
Reach other computers on your home network, and the internet (network:lan) |
Medium |
Open its own web page on your home network, at a port Starboard chooses (network:port) |
Medium |
What it runs:
- server: reaches your home network and the internet, and this computer as
host.docker.internal. It can use its own folder in Starboard's data (data/plugins/tdarr), thetdarr-cachefolder in your media folder, to read and change, themoviesfolder in your media folder, to read and change, thetvfolder in your media folder, to read and change. Its web page is on your home network at port 8265 when that port is free, or the next free one.
Like every plug-in, it runs read only, as a user that is not root, with no extra rights. Its image is pinned by digest, so what you approved is what runs.
Memory and processor
- server: 2048 MB of memory and 2 processor cores at most, and 512 processes.
Measured:
- 59.1 MiB at rest as Starboard runs it, with an empty library (13 November 2026).
- 748 MiB while it converted a file (13 November 2026).
Add it
- Go to Settings, then Plug-ins, then Catalogue.
- Under Apps you can add, find Tdarr and select Install….
- A slide-out opens with what it can read, change and reach. Read it all.
- Enter your Starboard password and select Install Tdarr. To stop, select Cancel: nothing is installed.
- Tdarr's own tab opens under Settings, then Plug-ins. Select Activate. Its state changes to Active.
Add it by its address
On the Catalogue page, under Add one from elsewhere, paste this into The plug-in's manifest address, then select What it does and carry on from step 3:
https://raw.githubusercontent.com/TheMightyTRex/starboard-plugins/main/tdarr/starboard-plugin.json
Or run its installer, install.py in its folder, on any computer with Python, and give your Starboard's address.
Set it up
If the main install already runs Tdarr
Do this before you activate the plug-in.
- On Tdarr's tab, under Your Tdarr, select Bring in the Tdarr you already have….
- Read which folders Starboard copies: Tdarr's
server,configsandlogsfolders. - Enter your Starboard password and select Copy.
- Select Activate. Its page is on your home network at port 8265 when that is free, as it is once your old Tdarr is stopped.
- Check the plug-in shows your libraries, then remove Tdarr from the main install: go to Settings, then Install apps, untick Tdarr and apply.
Starboard stops your Tdarr to copy its files whole. It does not remove it, and its own folders are never moved, changed or deleted. Its cache, the files part way through converting, is not copied. Its old folders (config/tdarr, beside the other apps' settings) stay until you move them to the holding folder in System, Clean up.
A new Tdarr
- Select Activate on Tdarr's tab.
- Go to Settings, then Apps, and select Search for new apps, so Starboard finds Tdarr and gives it a key.
- If its tab says Tdarr is not connected yet under Settings, select Connect Tdarr. Tdarr restarts once.
- Choose its libraries, what it does and when. Read Settings.
Open it
Tdarr's tab shows its address on your home network, under Its web page, with Open Tdarr. Anyone on your home network can open that page.
Remove it
- Go to Settings, then Plug-ins, then Tdarr.
- Under Remove, select Remove Tdarr.
- Choose where its folder goes: Keep it with Starboard's data (in
data/plugins/.removed) or Move it to the holding folder, listed in System, Clean up, where you can put it back or delete it for good. - Enter your Starboard password and select Remove.
Its containers stop and go, and its API key stops working. Nothing is deleted. Files it already changed in your media folder stay as they are.
To stop it for a while instead, select Deactivate on its tab: its settings and folder are kept.
Find out more
This page on GitHub, where the help is written.