# 04-bazarr.md

kstack:
  book: Centerpoint Home Lab
  chapter: Media Management
  page: Bazarr
  tags: [bazarr, subtitles, arr, media-management]
---

## Overview

Bazarr automatically downloads subtitles for movies and TV shows managed by Radarr
and Sonarr. It monitors both libraries and fetches subtitles from configured
providers (OpenSubtitles, Subscene, etc.) whenever a new file is added or an
existing file is missing subtitles.

## Access

| Type      | URL                           | Notes                              |
|-----------|-------------------------------|------------------------------------|
| Internal  | `https://bazarr.home.local`   | LAN access via Step-CA TLS         |

No external route — internal management only.

## Configuration

**Image:** `lscr.io/linuxserver/bazarr:latest`
**Compose project:** `arr` stack

### Traefik Labels

```yaml
traefik.enable: "true"
traefik.http.routers.bazarr.rule: Host(`bazarr.home.local`)
traefik.http.routers.bazarr.entrypoints: websecure
traefik.http.routers.bazarr.tls.certresolver: step-ca
traefik.http.services.bazarr.loadbalancer.server.port: 6767
```

## Volumes / Bind Mounts

| Host Path                              | Container Path | Purpose                          |
|----------------------------------------|----------------|----------------------------------|
| `/home/jeeves/docker/arr/Bazarr/config`| `/config`      | Bazarr database and settings     |
| `/mnt/Multimedia`                      | `/media`       | Media library for subtitle placement (NFS from UnRAID) |

The `/media` mount mirrors the Sonarr/Radarr mount so Bazarr can write subtitle
files directly alongside the video files in the library.

## Integration Points

| Service  | Connection                                   | Purpose               |
|----------|----------------------------------------------|-----------------------|
| Sonarr   | API (`http://sonarr:8989`) via `media-network` | TV library sync     |
| Radarr   | API (`http://radarr:7878`) via `media-network` | Movie library sync  |

## Notes / Gotchas

- Subtitle provider API keys (OpenSubtitles, etc.) are stored in Bazarr's settings.
  These are rate-limited — avoid aggressive subtitle searches on large libraries.
- Bazarr writes subtitle `.srt` or `.ass` files next to the video files in
  `/mnt/Multimedia`. Plex and Jellyfin pick these up automatically on the next
  library scan.
- If Sonarr or Radarr is restarted, Bazarr may take a few minutes to re-sync its
  library view via the API.

---
*Last Updated: 2026-06-16*