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
At a glance#
- What it is
- TV Show Manager Media
- Where it opens
- TV Shows
On its own port at
http://your-server:port, orsonarr.your-domainonce 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#
- Check the TV folder. On install LibrePortal adds
/media/tvto Sonarr as a root folder, which is where it files shows. You shouldn't need to touch it. - 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.
- 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/tvinside the shared media folder. When Jellyfin is installed, that is Jellyfin's ownmediafolder, 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 is | Who can reach it | With 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.
| Setting | What it does | Starts as |
|---|---|---|
NameCFG_SONARR_DISPLAY_NAME |
What this app is called on your dashboards. Leave empty to use its usual name | Empty |
Show on the LibrePortal DashboardCFG_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 SupportCFG_SONARR_DOMAIN_SUPPORT |
What this app can do with more than one address | one |
Domain ChangeCFG_SONARR_DOMAIN_CHANGE |
What moving it to another domain after install breaks | free |
Extra AddressesCFG_SONARR_ALIASES |
Other addresses that serve this app in full, comma-separated | Empty |
Old AddressesCFG_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.