Bazarr Setup Guide - ajgillis04/GillisDockerDepot GitHub Wiki
Bazarr Setup Guide
Introduction
Bazarr is a companion application to Sonarr and Radarr. It manages and downloads subtitles for movies and TV shows.
Prerequisites
- Docker installed
- Bazarr container running in your Docker stack
Configuration Steps
Step 1: Accessing the Bazarr UI
- Open your browser and navigate to
http://<your-ip-address>:6767. - Log in with your Bazarr credentials.
- Default Username:
admin - Default Password:
admin(or the password you set during initial setup)
- Default Username:
Step 2: Initial Setup Wizard
- Follow the initial setup wizard to configure basic settings.
- Choose your preferred language for the Bazarr interface.
- Find the Languages Profile section and select Add New Profile
- Get the API Key and copy it into your .env file

.env
BAZARR_API_KEY=TheKeyYouJustCopied
Step 3: Set Languages
- Choose languages from the left side menu
- Set the language filter to English
- Under Default Language Profiles Add New Profile.
- English
- English CC
- Default Language Profiles For Newly Added Shows
- Enable Series and Moves and set both to English

- Click Save
Step 4: Enable Providers
- Go to the
Providerstab. - I use OpenSubtitles, Supersubtitles, TVSubtitles, and YIFY Subtitles
- Note: for OpenSubtitles you need to create an account on their site

Step 5: Integrating with Sonarr and Radarr
- Go to the
SonarrorRadarrtabs. - Click
Enabled. - Enter the connection details, including the IP address, Port, and API key.
- Select
Test, to test your connection - Click
Save.

Step 6: Set Language Profiles for Series and Movies.
- If you restored from backup as i usually do you maybe need to go into series bulk edit and select English as the language profile

Forced Subtitles Only (Foreign-Language Scenes)
A common goal is subtitles only for the parts of an English movie or show where someone speaks another language. Those are called forced subtitles.
- Language profile: English with Forced =
True, set as the default for movies and series. - Most of them are already in your files. Many releases include a forced English track. Bazarr counts embedded tracks when Use embedded subtitles is on, so nothing needs downloading. If you use Tdarr, make sure your flow keeps English subtitle tracks (see Tdarr Server Setup Guide).
- Expect a huge "Wanted" list. Bazarr can't tell which titles have foreign dialogue, so every title without a forced track counts as missing, often thousands. That's normal: most simply don't have foreign dialogue. Adaptive searching slows the search for each title to about once a week after a few weeks, and searching costs nothing (only downloads count against provider limits).
- Turn it on in Plex: forced tracks only appear automatically if your Plex account's Settings → Languages → Subtitle mode is set to Only forced subtitles (or Shown with foreign audio). It's a per-user setting.
- For one-off gaps: the Plex player's Subtitles → Search finds a subtitle on the spot.
Providers Worth Enabling
- OpenSubtitles.com with an account (without one, downloads are limited to a handful a day).
- Addic7ed with an account, and Gestdown (a fast Addic7ed mirror, no account) for TV.
- SubDL (free API key) and Podnapisi for movies and TV.
- Saving an account or API key in a provider's settings doesn't switch it on; check it's in the enabled list.
AI-generated subtitles (Whisper, see Subgen Setup Guide) transcribe everything said, so they make full subtitles rather than forced ones.
Notes
- Ensure all paths and environment variables are updated in the
bazarr.yamlfile. - Regularly backup your
configdirectory to save your settings.
Backup and Restore Procedures
Regular Backups:
- I perform weekly backups of my
config.yamlandbazarr.dbfiles. This ensures that I can easily recover from any disasters or transition smoothly to a new server.
Restoration Process:
-
Start a New Container:
- Create and start a new Bazarr container.
- Once started, stop the container to prepare for the restoration of configuration files.
-
Copy Configuration Files:
- Use the following command to copy the configuration files from the old container to the new container folder:
sudo cp /share/PathToOldContainer/bazarr/config/config.yaml /share/PathtoNewFolder/GillisDockerDepot/appdata/bazarr/config/config.yaml sudo cp /share/PathToOldContainer/bazarr/config/bazarr.db /share/PathtoNewFolder/GillisDockerDepot/appdata/bazarr/config/bazarr.db
- Use the following command to copy the configuration files from the old container to the new container folder:
Troubleshooting
- Common Issues: List common issues and solutions.
- Logs: Check Bazarr logs for error messages.
- Support: Link to the Bazarr community and support resources.