Migrating from Bazarr
Sublarr can read Bazarr’s own files and take over the parts that carry over cleanly. You see what each setting would replace before anything is written.
What is imported
Section titled “What is imported”| From Bazarr | Becomes in Sublarr |
|---|---|
| Sonarr address + API key | Sonarr connection |
| Radarr address + API key | Radarr connection |
| OpenSubtitles.com username + password | OpenSubtitles login |
| Language profiles | Language profiles (source language English — check them afterwards) |
| Blacklist | Blacklist |
Blacklist entries keep Bazarr’s provider name and subtitle ID. They only block a download where Sublarr’s provider uses the same name and ID — OpenSubtitles entries, for example, do not carry over in a usable form.
Not imported: download history, and provider settings other than OpenSubtitles. Your subtitle files are never touched — the import only writes Sublarr’s own settings.
Which files to use
Section titled “Which files to use”Bazarr keeps what you need in its config folder:
config/config.yaml(older versions:config.ini): connections and loginsdb/bazarr.db: language profiles and blacklist
Upload either one, both, or a ZIP of the whole Bazarr config folder.
- Open Settings → System → Diagnostics and switch on the advanced settings. The Migration section appears at the bottom.
- Choose the config file and/or
bazarr.db, then click Analyze Files. - Check the preview. Every setting shows the value it would write. If Sublarr already has a value there, the preview shows that too (“currently: …”). API keys and passwords are shortened on both sides.
- Click Confirm Import. The summary lists what was imported and any notes.
The same import is also available for a single file from the Bazarr Migration button under Settings → System → API Keys (advanced settings).
Addresses Sublarr cannot reach
Section titled “Addresses Sublarr cannot reach”Bazarr and Sublarr usually run in different containers. If Bazarr talks to
Sonarr as 127.0.0.1 or localhost, that address points at Bazarr’s own
container, not at Sonarr, so the import skips that connection and tells you.
The same applies to other addresses Sublarr refuses to connect to. Enter the
address under Settings → Connections instead. A hostname such as
sonarr from a shared Docker network is imported as it is.
Running both side by side
Section titled “Running both side by side”You can keep Bazarr running. Avoid letting both manage the same series: both write subtitles next to the video file and both use your provider quota. A common split is Sublarr for anime and Bazarr for everything else.