Maintainerr: Install
Add Maintainerr 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, Maintainerr is active, with its own page on your home network, and set up.
Before you begin
- Starboard with plug-in API 1.14 or later. An older Starboard is offered an earlier version: read Updates.
- Jellyfin added to Starboard, in Settings, Apps. Maintainerr works with it.
- Your Starboard password. Adding and removing a plug-in ask for it.
- An API key for Maintainerr made in Jellyfin, and one made in Seerr if you have it. Starboard gives Maintainerr no key.
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:
- app: 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/maintainerr). Its web page is on your home network at port 6246 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
- app: 384 MB of memory and 0.5 of a processor core at most, and 128 processes.
Measured:
- 140.3 MiB at rest as Starboard runs it, with an empty library (13 November 2026).
Add it
- Go to Settings, then Plug-ins, then Catalogue.
- Under Apps you can add, find Maintainerr 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 Maintainerr. To stop, select Cancel: nothing is installed.
- Maintainerr'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/maintainerr/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
Maintainerr's tab shows its address on your home network, under Its web page.
- On Maintainerr's tab, under Its web page, select Open Maintainerr. Its page opens in a new tab.
- In Maintainerr, add Jellyfin with the key you made in Jellyfin.
- If you have Seerr, add it too, with a key you made in Seerr.
- Make a rule, such as films everyone has watched and older than 90 days, and check what it finds.
- Give a rule an action only when you are happy with what it finds.
Nothing is removed until you give a rule an action and the keys allow it. Starboard gives Maintainerr no key and no media folder, so it removes through Jellyfin or Seerr only.
Remove it
- Go to Settings, then Plug-ins, then Maintainerr.
- Under Remove, select Remove Maintainerr.
- 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.
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.