Start here

Add a service

The service editor is the one form Managerr asks you to fill in. This page goes through it field by field, and says why Save stays switched off until a test has passed.

Opening the editor

The editor opens from a tile or the Add a Service button on the welcome screen, and afterwards from Settings → Services → Add a Service. It is the same form either way.

Have the service’s API key to hand before you start. Managerr cannot fetch it for you — it lives in that service’s own settings, and the table further down says where.

Service and name

Three fields, in order: a Service picker, a Name field with the placeholder “Name, e.g. Movies · Home”, and an address field with the placeholder showing that service’s stock port, for example http://192.168.1.10:8989.

The Service picker is locked when you are editing a service that already exists. The kind of a saved service cannot be changed; to turn a Sonarr entry into a Radarr one, remove it and add the other.

The name is optional. Left blank, Managerr uses the address’s host, or failing that the service’s own name. A name you will recognise is worth typing when you run more than one of the same service — “Movies · Home” tells you more at a glance than a repeated IP address.

The address

The address is checked before anything is sent, and these rules are all enforced.

It must be http or https.
A bare address such as 192.168.1.10:8989 is taken as http://.
Trailing slashes are trimmed.
An address carrying a username, password, query string or fragment is refused.
Include the port, and any base path the service is served under — http://192.168.1.10:8989/sonarr.

If the service sits under a path, that path belongs in the address. Managerr does not go looking for it, and a missing base path is the usual reason a test fails against a server you can open in a browser on the same device. Reaching your servers covers addresses and reachability.

The API key

The key goes into a masked field with a Show key / Hide key button beside it, for checking a long paste. It is stored in a device-only Keychain entry, never in the ordinary configuration file. For Seerr, it must be the owner’s API key.

Where each key lives
Service	Stock port	Where the API key lives
Sonarr	8989	Its own Settings → General → Security
Radarr	7878	Its own Settings → General → Security
Lidarr	8686	Its own Settings → General → Security
Prowlarr	9696	Its own Settings → General → Security
Seerr	5055	Its own Settings → General, using the owner account
Tautulli	8181	Its own Settings → Web Interface → API

Custom headers

Below the key you can add any number of rows, each a header name and a value, for a reverse proxy or extra authentication sitting in front of the service. Values are stored in Keychain with the key.

Header names must use valid HTTP token characters, and duplicate names are refused. Four names are reserved and rejected: x-api-key, Host, Content-Length and Cookie. Managerr manages the API-key header itself.

If nothing stands in front of your services, leave this section empty. Reverse proxies & headers says what to put in the rows when something does.

Test, then save

Test Service becomes available once both an address and an API key are present. A success shows “Connected · ” and the version the server reported.

Save is disabled until the exact values in front of you have tested successfully. Change anything after a successful test — a character of the address, the name, a header — and Save switches off again, with the line “Something changed since the last successful test. Test again to enable Save.”

The test confirms access with those values at that moment. Individual features can still depend on permissions, server configuration and API compatibility. If a saved service later fails, check the reported error and the troubleshooting guide.

Cancel clears the typed key rather than leaving it in memory.

Changing it later

Open Settings → Services and tap a service to edit it. An edit is held to the same rule: test it again before Save comes back.

Press and hold a service row for three more actions.

Edit Service: The same editor, with the Service picker locked.
Copy Service: Duplicates the configuration with “ Copy” added to the name. This is the quick way to add a second instance on the same server.
Remove Service: Takes the service out of Managerr. It changes nothing on the server itself.

What each server then drives inside the app is on its own page: Sonarr, Radarr & Lidarr, Prowlarr, Seerr and Tautulli.