LibrePortal
Sponsor Get started

Sonarr

TV Show Manager

Sonarr is the part of your media setup that looks after TV shows. You pick the shows you follow, it finds new episodes as they come out, fetches them and files them neatly, and your media server picks them up from there.

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
TV Show Manager Media
Where it opens
TV Shows On its own port at http://your-server:port, or sonarr.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#

Following a TV show by hand means checking when episodes are out, getting each one, and naming and sorting the files. Sonarr does it for you. You add a show, say which seasons you want, and it watches for new episodes, fetches them through a download client (the program that does the actual downloading) and puts them in a folder per show and season.

Sonarr is for TV shows. Its sibling Radarr does the same for films. Neither plays anything: that is the job of a media server such as Jellyfin.

Sonarr needs two other things

Sonarr finds episodes by asking search sites (called indexers), and it needs a download client to fetch them. LibrePortal doesn't choose either for you. Prowlarr keeps your search sites in one place and shares them with Sonarr, and Decypharr can be the download client if you use Real-Debrid. You add your own search sites and download client yourself.

Signing in#

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

If LibrePortal can't set the sign-in, the install says so, and Sonarr asks you to choose a user and password the first time you open it. If you change the password inside Sonarr, do it there; LibrePortal only sets it once.

How to use it#

  1. Check the TV folder. On install LibrePortal adds /media/tv to Sonarr as a root folder, which is where it files shows. You shouldn't need to touch it.
  2. Add a download client. In Sonarr, open Settings and then Download Clients, and add the one you use. With Decypharr installed through Jellyfin's extras, this is already done.
  3. Add a show. Use the search box, pick the show, choose the root folder and add it. Sonarr starts looking straight away and keeps watching for new episodes.

Your search sites come from Prowlarr if you have it. If not, add them in Sonarr under Settings, then Indexers.

Works with#

  • Jellyfin. Sonarr saves shows in /media/tv inside the shared media folder. When Jellyfin is installed, that is Jellyfin's own media folder, and the Automatic films & TV extra gives Jellyfin a Shows library for it. Without Jellyfin, Sonarr keeps a media folder of its own.
  • Prowlarr. Prowlarr shares its search sites with Sonarr, and keeps them in step when you change them.
  • Seerr. Seerr lets the people you share with ask for shows, and sends those requests to Sonarr.
  • Decypharr. Added to Sonarr as its download client, so episodes come from your Real-Debrid account.
  • Bazarr. Bazarr watches Sonarr's show list and finds subtitles for what is in it.

The easy way to get all of these connected is Tools on Jellyfin's page, then Add or Remove Extras. LibrePortal installs the apps and links them for you. You can also install Sonarr alone from the App Center and connect things yourself.

Good to know#

  • It is limited to 1 GB of memory. With the other helper apps, expect about 1.5 GB for the whole set.
  • 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 Sonarr doesn't answer afterwards.
  • Usage analytics are switched off. Sonarr does look up show details from its own online metadata service when you add a show, and it sends your searches to whichever search sites you add.
  • Backups are on by default. Sonarr's settings and show list are in them.
  • One per server.

Addresses and ports#

Sonarr 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
TV Shows Anyone sonarr.your-domain

Settings#

In its config file#

Sonarr'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_SONARR_DISPLAY_NAME
What this app is called on your dashboards. Leave empty to use its usual name Empty
Show on the LibrePortal Dashboard
CFG_SONARR_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_SONARR_DOMAIN_SUPPORT
What this app can do with more than one address one
Domain Change
CFG_SONARR_DOMAIN_CHANGE
What moving it to another domain after install breaks free
Extra Addresses
CFG_SONARR_ALIASES
Other addresses that serve this app in full, comma-separated Empty
Old Addresses
CFG_SONARR_REDIRECTS
Other addresses that send visitors on to this app, comma-separated Empty

Works with#

These are the other apps Sonarr 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 Sonarr looks up show details from Sonarr's metadata service and asks your indexers for releases. Analytics are turned off.

What leaves this server#

  • Show titles and ids go to Sonarr's metadata service (skyhook, TheTVDB data) when you add a show
  • Searches go to the indexers you add

What LibrePortal turns off#

  • Usage analytics (Sonarr'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/sonarr:4.0.20.3014-ls2@sha256:386c962ee6e260e3a5656b25df2ed056bcc9b6410e197d075f9547fd14c23bca.
  • It can sit behind Authelia's sign-in once Authelia is installed.
  • Its own project and documentation: github.com/Sonarr/Sonarr

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