Files
homelab-optimized/docs/services/individual/bazarr.md
Gitea Mirror Bot c727d0bfb1
Some checks failed
Documentation / Deploy to GitHub Pages (push) Has been cancelled
Documentation / Build Docusaurus (push) Has been cancelled
Sanitized mirror from private repository - 2026-03-24 12:45:58 UTC
2026-03-24 12:45:58 +00:00

126 lines
3.6 KiB
Markdown

# Bazarr
**🟢 Media Service**
## Service Overview
| Property | Value |
|----------|-------|
| **Service Name** | bazarr |
| **Host** | Atlantis (Synology) |
| **Category** | Media / Subtitles |
| **Docker Image** | `lscr.io/linuxserver/bazarr:latest` |
| **Compose File** | `hosts/synology/atlantis/arr-suite/docker-compose.yml` |
| **URL** | http://192.168.0.200:6767 |
| **Version** | 1.5.6 |
## Purpose
Bazarr is the subtitle companion to Sonarr and Radarr. It monitors your library for missing or
wanted subtitles, searches configured providers, and downloads them automatically. It syncs
directly with Sonarr/Radarr via SignalR so new items trigger subtitle searches immediately.
## API Access
| Field | Value |
|-------|-------|
| **URL** | http://192.168.0.200:6767 |
| **API Key** | `REDACTED_BAZARR_API_KEY` |
| **Header** | `X-Api-Key: "REDACTED_API_KEY"` |
```bash
BAZARR="http://192.168.0.200:6767"
BAZARR_KEY="REDACTED_BAZARR_API_KEY"
# System status and version
curl -s "$BAZARR/api/system/status" -H "X-Api-Key: $BAZARR_KEY" | python3 -m json.tool
# Health check
curl -s "$BAZARR/api/system/health" -H "X-Api-Key: $BAZARR_KEY" | python3 -m json.tool
# Missing subtitles count
curl -s "$BAZARR/api/badges" -H "X-Api-Key: $BAZARR_KEY" | python3 -m json.tool
# List missing episode subtitles
curl -s "$BAZARR/api/episodes/wanted" -H "X-Api-Key: $BAZARR_KEY" | python3 -m json.tool
# List missing movie subtitles
curl -s "$BAZARR/api/movies/wanted" -H "X-Api-Key: $BAZARR_KEY" | python3 -m json.tool
```
## Current Status (2026-03-02)
- Sonarr SignalR: **LIVE**
- Radarr SignalR: **LIVE**
- Missing episode subtitles: 846
- Missing movie subtitles: 6
- Provider issues: 0
## Configuration
### Docker Compose (in docker-compose.yml)
```yaml
bazarr:
image: lscr.io/linuxserver/bazarr:latest
container_name: bazarr
environment:
- PUID=1029
- PGID=100
- TZ=America/Los_Angeles
- UMASK=022
- DOCKER_MODS=ghcr.io/themepark-dev/theme.park:bazarr
- TP_SCHEME=http
- TP_DOMAIN=192.168.0.200:8580
- TP_THEME=dracula
volumes:
- /volume2/metadata/docker2/bazarr:/config
- /volume1/data:/data
ports:
- "6767:6767"
networks:
media2_net:
ipv4_address: 172.24.0.x
security_opt:
- no-new-privileges:true
restart: always
```
Config on Atlantis: `/volume2/metadata/docker2/bazarr/config/config.yaml`
Note: The API key is stored in `config.yaml` on Atlantis (not in this repo). Retrieve it with:
```bash
grep "apikey" /volume2/metadata/docker2/bazarr/config/config.yaml
```
## Connected Services
| Service | Connection | Status |
|---------|-----------|--------|
| Sonarr | SignalR + API | LIVE |
| Radarr | SignalR + API | LIVE |
Bazarr connects *to* Sonarr/Radarr (not the reverse). Configure under
Settings → Sonarr and Settings → Radarr in the Bazarr UI.
## Troubleshooting
**SignalR shows CONNECTING or DISCONNECTED**
- Verify Sonarr/Radarr are running: `docker ps | grep -E 'sonarr|radarr'`
- Check the host/API key in Bazarr Settings → Sonarr/Radarr
- Restart Bazarr: `docker restart bazarr`
**No subtitle providers**
- Check badges: `providers` field should be 0 for no errors
- Go to Settings → Providers in the Bazarr UI to configure providers (OpenSubtitles, etc.)
**Subtitle not found for a specific episode**
- Go to the episode in Bazarr → Manual Search to browse provider results
- Check the episode language profile matches what providers offer
## Related Services
- Sonarr — http://192.168.0.200:8989
- Radarr — http://192.168.0.200:7878
- See also: `docs/services/individual/download-priority.md` for the NZB-first strategy