LibrePortal
Sponsor Get started

Bazarr

Subtitle Manager

Bazarr finds and keeps subtitles for the shows and films that Sonarr and Radarr manage, in the languages you choose.

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
Subtitle Manager Media
Where it opens
Subtitles On its own port at http://your-server:port, or bazarr.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#

Subtitles help when the audio is in another language, when someone is hard of hearing, or when you simply can't hear the dialogue over the washing machine. Hunting them down file by file is tedious. Bazarr looks at the shows in Sonarr and the films in Radarr, finds subtitles for each one in the languages you pick, and saves them beside the video. Your media server, such as Jellyfin, then offers them when you play.

Signing in#

Bazarr is never left open. Before its first start LibrePortal writes a user name and password into its settings, and also a key that other apps use to talk to it. The user name and password are in the Login Details shown when the install finishes. Press Welcome on the app's page to see them again. Open Bazarr with the Web Interface button.

If LibrePortal had no generated login to use, Bazarr asks you to make one the first time you open it.

How to use it#

  1. Choose your languages. In Bazarr, open Settings, then Languages. Add the languages you want, and set up a language profile (a named list of languages) to give to your shows and films.
  2. Add subtitle sites. Under Settings, then Providers, switch on the sites Bazarr should search. You pick them, and some ask for an account of their own.
  3. Check Sonarr and Radarr are connected. Under Settings, then Sonarr and Radarr, they should be switched on. Bazarr then lists your shows and films and starts looking.

Works with#

  • Sonarr and Radarr. With Jellyfin's Subtitles extra, LibrePortal connects Bazarr to both, using their addresses on your server and their keys, so you type nothing. If you installed Bazarr on its own, switch them on yourself under Settings.
  • Jellyfin. Bazarr reads the same media folder as Jellyfin, so the subtitles it saves sit next to the videos Jellyfin plays. The extra is under Tools and Add or Remove Extras on Jellyfin's page. It also installs Sonarr and Radarr if they aren't there.
  • Decypharr. If you stream from Real-Debrid, Bazarr gets the same mounted folder, so it can see those files too.

Good to know#

  • Subtitle sites see what you look for. Bazarr sends the title and a file fingerprint (a hash) of each video to the sites you turn on. It also checks Bazarr's own servers for updates and announcements.
  • 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 Bazarr doesn't answer afterwards.
  • Backups are on by default.
  • One per server.

Addresses and ports#

Bazarr 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
Subtitles Anyone bazarr.your-domain

Settings#

In its config file#

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

Works with#

These are the other apps Bazarr 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: Finds subtitles for your shows and films.
  • 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 Bazarr asks the subtitle sites you choose for subtitles, sending the title and file hash of what it is looking for.

What leaves this server#

  • Titles and file hashes go to the subtitle providers you turn on
  • Update and announcement checks to Bazarr's own servers

What LibrePortal turns off#

Nothing needed switching off.

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/bazarr:v1.6.2-ls371@sha256:7ef0e58216900dbce30b123e0eb65f5cb30e36f126de9474acdd2022fb069c54.
  • It can sit behind Authelia's sign-in once Authelia is installed.
  • Its own project and documentation: github.com/morpheus65535/bazarr

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