Skip to main content

Initial Setup and Configuation

In this guide, we’ll be setting up Bazarr for the first time. This guide assumes the following:

  • You’ll be setting up your library for the first time and your library is saved locally under ~/media
  • You have both Radarr and Sonarr installed and configured

We’ll be doing the following steps:

  • Setting up reverse proxy
  • Setting up subtitle providers
  • Connecting Sonarr and Radarr

  • Setting up username and password

Initial Setup

Setting Up Reverse Proxy

  • Upon successful installation, wait for up to 5 minutes for Bazarr to initialize.
  • After clicking Connect on the UCP, you’ll be shown with Bazarr’s first time setup guide.
  • In this screen, add /bazarr/ under Base URL (1)
  • You may leave the other settings as-is. Click next to save and move on to the next step (2)

Setting Up Subtitle Providers

  • Here, we will set up subtitle providers.
  • On subtitles options section, leave both options as-is
    • Plex requires that subtitle files should be at the same location as your movie file for it to be detected

  • Then enable the subtitle providers that you wish to use
    • Some providers require you to add your credentials. Be sure to enter it accordingly
    • There are also some providers that needed anti-captcha API key. You can add the API key after the setup has finished

  • Under Subtitle languages, click the dropdown box on enabled languages and select your preferred languages for Bazarr to search

  • Then you can set the defaults for both Series and Movies
    • Here, you can set the default parameters and languages that you wish to search and download.
    • You can leave them as default and set them later or do it now, as shown in the following screenshot

  • Once that’s done, click Next

Connecting Sonarr and Radarr to Bazarr

  • Here, you’ll be connecting your Sonarr instance to Bazarr
  • Login to your Sonarr instance and go to Settings -> General

  • Then under Security, copy the API key provided

  • In Sonarr, enable Use Sonarr and input the following
Hostname or IP address: username.lwxxx.usbx.me
Listening port: 443
Base URL: /sonarr
SSL enabled: On
API Key: >paste Sonarr API key here<
Download Only Monitored: Enabled (Recommended)
  • Once that’s done, Click the test button to validate the settings.
  • If it shows green text, click next to move on to the next step

  • Repeat the same steps on Radarr, using the following information
Hostname or IP address: username.lwxxx.usbx.me
Listening port: 443
Base URL: /radarr
SSL enabled: On
API Key: >paste Radarr API key here<
Download Only Monitored: Enabled (Recommended)
  • To get Radarr's API key, select Settings -> General and copy the API key Under Security Settings

  • Click save to save your changes once testing is passed

  • Then click Restart on the red banner to restart the instance to properly apply the changes

  • After 1 minute or so, access your bazarr via https://username.lwxxx.usbx.me/bazarr

Setting Up Username and Password

  • Click Setting
  • Then on General settings, under Security settings Click on the Authentication dropbox and select either Basic (browser popup) or Forms (Login Page).
    • We recommend selecting Forms (Login page) since it is non-intrusive and works on password managers
  • Then input the credentials that you want
  • Once that’s done, click Save and restart the instance when prompted
  • Wait for a few minutes. It’ll redirect directly to your login page. Login using your set credentials to proceed.

Settings Overview

General

  • Here you set Bazarr’s general settings. Here you can find the following relevant settings:
    • Security settings to set your credentials
    • Your Bazarr API Key
    • Sonarr and Radarr Integration switches
    • Path Mappings for both Movies and TV Shows
      • This is used when your Radarr/Sonarr Instance is on another machine
    • Setting up post-processing commands
    • Analytics for the Developers

Sonarr and Radarr

  • In these pages, you can enter your sonarr and radarr credentials
  • Here you may opt to enter if you want Bazarr to download only monitored releases

Subtitles

  • Here, you can set which providers Bazarr looks for subtitles.
  • You can set on the minimum rating for subtitles, where Bazarr saves your subtitles, and other options for subtitles
  • Each subtitle provider requires either your token, your API key or your credentials. Some providers needed an anti-captcha key which you can also put in here.

Notifications

  • Here, you can set notifications if Bazarr grabbed has grabbed any subtitles