LibrePortal
Sponsor Get started

Prowlarr

Search Manager

Prowlarr keeps all your search sites in one place and shares them with Sonarr and Radarr. You set each site up once, and both apps use it.

On this page
  1. At a glance
  2. What it's good for
  3. Signing in
  4. How to use it
  5. Works with
  6. Good to know
  7. Addresses and ports
  8. Settings
  9. In its config file
  10. Works with
  11. Privacy and security
  12. What leaves this server
  13. What LibrePortal turns off
  14. Sources
  15. Under the hood

At a glance#

What it is
Search Manager Media
Where it opens
Search Manager On its own port at http://your-server:port, or prowlarr.your-domain once you have a domain
Updates
Automatic A backup is taken first, and it rolls back if the update fails
Backups
Included Part of the daily backup when that's switched on
Copies
One per server

What it's good for#

Sonarr and Radarr find shows and films by asking search sites, which the apps call indexers. Without Prowlarr you would add every site to both apps, and again to each one whenever a site changes its details.

Prowlarr is the one list. You add a search site to it once, and it pushes that site to Sonarr and Radarr and keeps them in step. It never downloads anything itself. Its only job is searching.

You choose the search sites

LibrePortal installs Prowlarr empty. Which sites to add is your decision, and it is up to you to use them lawfully where you live.

Signing in#

Prowlarr is never left open. LibrePortal switches on its sign-in after the first start, with a user name and password it makes for you. They are in the Login Details shown when the install finishes. Press Welcome on the app's page to see them again. Open Prowlarr with the Web Interface button.

If LibrePortal can't set the sign-in, the install says so, and Prowlarr asks you to choose a user and password the first time you open it.

How to use it#

  1. Add a search site. In Prowlarr, open Indexers, then add one from its list and fill in what it asks for.
  2. Check it connects to Sonarr and Radarr. In Settings, then Apps, you should see Sonarr and Radarr listed if you installed them through Jellyfin's extras. If you installed them separately, add them there yourself, using each app's address and its API key (a long secret the apps use to talk to each other).
  3. Test a search. Use Prowlarr's own search box. If results come back, Sonarr and Radarr will find them too.

Works with#

  • Sonarr and Radarr. When you use Jellyfin's Automatic films & TV extra, LibrePortal connects Prowlarr to both for you, with its sync level set to full. Every search site you add in Prowlarr then shows up in them without any more steps.
  • Jellyfin. The extra that installs Prowlarr lives on Jellyfin's page, under Tools and Add or Remove Extras.
  • Gluetun. The Use a VPN extra sends Prowlarr's searches through Gluetun, a program that connects your server to a VPN company of your choice. The idea is that your server's own address stays out of the searches. LibrePortal tests the VPN first, and if it drops, the searches stop rather than going out openly. If the test fails, Prowlarr is left stopped.

Good to know#

  • It is limited to 1 GB of memory.
  • Updates are automatic. LibrePortal pins an exact version and offers newer ones as a step. A recovery snapshot is taken first, and the update is rolled back if Prowlarr doesn't answer afterwards.
  • Usage analytics are switched off. Prowlarr fetches its list of supported search sites from its public list, and sends your searches to the sites you add.
  • Backups are on by default.
  • One per server.

Addresses and ports#

Prowlarr has one port. LibrePortal picks a free port number for each when you install, so yours will differ from anyone else's. The Config tab's Network section shows them, and the app's Open button uses the right one. "Anyone" means it's reachable from wherever your server is reachable; you can make it private later.

What it isWho can reach itWith a domain
Search Manager Anyone prowlarr.your-domain

Settings#

In its config file#

Prowlarr's own settings aren't on the Config tab yet. They live in the app's config file, described here so you know they exist. How to change them.

SettingWhat it doesStarts as
Name
CFG_PROWLARR_DISPLAY_NAME
What this app is called on your dashboards. Leave empty to use its usual name Empty
Show on the LibrePortal Dashboard
CFG_PROWLARR_SHOW_ON_DASHBOARD
Whether this app gets a shortcut on the front page of the LibrePortal WebUI, separate from any Dashy dashboard
Choices: true, false
false
Domain Support
CFG_PROWLARR_DOMAIN_SUPPORT
What this app can do with more than one address one
Domain Change
CFG_PROWLARR_DOMAIN_CHANGE
What moving it to another domain after install breaks free
Extra Addresses
CFG_PROWLARR_ALIASES
Other addresses that serve this app in full, comma-separated Empty
Old Addresses
CFG_PROWLARR_REDIRECTS
Other addresses that send visitors on to this app, comma-separated Empty

Works with#

These are the other apps Prowlarr knows how to work with. Once it's installed, its page shows the same list with whether each one is connected. How this works.

  • Grafana: Shows dashboards for the apps that have one. works with every app
  • Jellyfin: Ask for a film or show and it is found and added to Jellyfin.
  • Prometheus: Collects metrics from the apps that can export them. works with every app
  • Uptime Kuma: Watches your apps and shows when one goes down. works with every app

Privacy and security#

Worth knowing Prowlarr sends your searches to the indexers you add. With a VPN set up, LibrePortal sends them through Gluetun. Analytics are turned off.

What leaves this server#

  • Searches go to the indexers you add (through Gluetun when the VPN extra is on)
  • Its indexer definitions are fetched from Prowlarr's public list

What LibrePortal turns off#

  • Usage analytics (Prowlarr's own option, off in the compose)

Licence: GPL-3.0. Audited: 4 November 2026. See the privacy of every app and the Promise.

Sources#

Under the hood#

  • It runs this image: lscr.io/linuxserver/prowlarr:2.7.0.5723-ls167@sha256:431d7efebcef466e56adaa40a7a2fa2b0e85159a037b8bf465eaadbf0cf5bedf.
  • It can sit behind Authelia's sign-in once Authelia is installed.
  • Its own project and documentation: github.com/Prowlarr/Prowlarr

Ports, settings, tools and connections on this page are read from LibrePortal v0.10.130's app catalogue each time the guide is built.

Next steps