Bazarr finds and keeps subtitles for the shows and films that Sonarr and Radarr manage, in the languages you choose.
On this page
At a glance#
- What it is
- Subtitle Manager Media
- Where it opens
- Subtitles
On its own port at
http://your-server:port, orbazarr.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#
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#
- 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.
- 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.
- 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 is | Who can reach it | With 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.
| Setting | What it does | Starts as |
|---|---|---|
NameCFG_BAZARR_DISPLAY_NAME |
What this app is called on your dashboards. Leave empty to use its usual name | Empty |
Show on the LibrePortal DashboardCFG_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 SupportCFG_BAZARR_DOMAIN_SUPPORT |
What this app can do with more than one address | one |
Domain ChangeCFG_BAZARR_DOMAIN_CHANGE |
What moving it to another domain after install breaks | free |
Extra AddressesCFG_BAZARR_ALIASES |
Other addresses that serve this app in full, comma-separated | Empty |
Old AddressesCFG_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.