Bazarr manages subtitle discovery, download, and upgrade workflows for the Smithflix movie and TV libraries.
This page documents the bazarr service. It depends on healthy Radarr and Sonarr integrations but does not replace those pages.
- Container:
bazarr
- Image:
lscr.io/linuxserver/bazarr:latest
- Stack: Smithflix Stack
- Compose path:
/opt/stacks/smithflix/docker-compose.yml
- Docker network:
smithflix_default
- Restart policy:
unless-stopped
- Health state: healthy on
2026-04-07
- Public hostname:
bazarr.better-than.tv
¶ Config and Data Paths
- Config root:
/srv/docker/bazarr/config
- Main config file:
/srv/docker/bazarr/config/config/config.yaml
- Database:
/srv/docker/bazarr/config/db/bazarr.db
- App log file:
/srv/docker/bazarr/config/log/bazarr.log
- Backup directory:
/srv/docker/bazarr/config/backup
- Media library mounts:
/media/movies and /media/tv
- LAN URL:
http://192.168.0.113:6767
- Public URL:
https://bazarr.better-than.tv
- Host port mapping:
6767 -> 6767
¶ Authentication and Secret Locations
- Bazarr auth, provider settings, and Arr integrations are stored inside
/srv/docker/bazarr/config
- Do not copy provider credentials or API keys into wiki content
- Public access should remain limited to trusted operators because the app can modify subtitle state across the media library
- Keep Radarr and Sonarr connectivity healthy because Bazarr relies on them for library inventory and target metadata
- Verify local access on
:6767 before debugging the proxy
- The presence of rotating backup ZIP files under
/srv/docker/bazarr/config/backup indicates Bazarr's internal backup mechanism is active
- If subtitle results appear sparse, review provider throttling and adaptive search behavior before changing library-wide settings
¶ Monitoring and Logs
- Docker logging driver is
json-file
- The container healthcheck was healthy on
2026-04-07
- Recent logs showed routine subtitle indexing, missing-subtitle searches, and adaptive-search throttling for at least one movie
- App-level logs are stored in
/srv/docker/bazarr/config/log
¶ Backup and Restore
/srv/docker/bazarr/config is in the documented Duplicati scope because it lives under /srv/docker- The media libraries under
/media are operational library data, not assumed full backups
- After restore, validate Radarr and Sonarr integration plus a sample subtitle search path
¶ Failure Modes and Recovery
- If Radarr or Sonarr integration breaks, Bazarr can stay up while subtitle automation quietly degrades
- Provider throttling or provider auth drift can reduce subtitle coverage without causing container-level failures
- Permission drift on the media library mounts can block subtitle writes even when the UI remains available