diff --git a/Netgrimoire/Services/bazarr/bazarr.md b/Netgrimoire/Services/bazarr/bazarr.md new file mode 100644 index 0000000..d95570f --- /dev/null +++ b/Netgrimoire/Services/bazarr/bazarr.md @@ -0,0 +1,125 @@ +--- +title: bazarr Stack +description: Bazarr Stack for NetGrimoire +published: true +date: 2026-04-04T01:35:32.755Z +tags: docker,swarm,bazarr,netgrimoire +editor: markdown +dateCreated: 2026-04-04T01:35:32.755Z +--- + +# bazarr + +## Overview +The bazarr stack is a Docker Swarm configuration for the Bazarr service in NetGrimoire. It provides a search functionality and connects to other services through various labels and environment variables. + +--- + +## Architecture +| Service | Image | Port | Role | +|---------|-------|------|------| +- **Host:** docker4 +- **Network:** netgrimoire +- **Exposed via:** bazarr.netgrimoire.com +- **Homepage group:** Jolly Roger + +--- + +## Build & Configuration + +### Prerequisites +To deploy this stack, ensure that Docker Swarm is installed and configured. + +### Volume Setup +```bash +mkdir -p /DockerVol/bazarr/config +chown -R user:group bazarr.config +``` + +### Environment Variables +```bash +# generate: openssl rand -hex 32 +PUID=1964 +PGID=1964 +TZ=America/Chicago +Caddy: authentik +Caddy.reverse_proxy: {{upstreams 6767}} +Kuma.bazarr.http.name=Bazarr +Kuma.bazarr.http.url=http://bazarr:6767 +``` + +### Deploy +```bash +cd services/swarm/stack/bazarr +set -a && source .env && set +a +docker stack config --compose-file bazarr-stack.yml > resolved.yml +docker stack deploy --compose-file resolved.yml bazarr +rm resolved.yml +docker stack services bazarr +``` + +### First Run +After deployment, run `./deploy.sh` to initialize the configuration. + +--- + +## User Guide + +### Accessing bazarr +| Service | URL | Purpose | +|---------|-----|---------| +- **Bazarr**: http://bazarr.netgrimoire.com +- **Caddy reverse proxy:** Internal only + +### Primary Use Cases +Use Bazarr for subtitle search in NetGrimoire. + +### NetGrimoire Integrations +This service connects to Uptime Kuma and Caddy through various labels and environment variables. + +--- + +## Operations + +### Monitoring +```bash +docker stack services bazarr +docker service logs -f bazarr +``` + +### Backups +- `/DockerVol/bazarr/config` is critical for configuration data. +- `/DockerVol/bazarr/data` is reconstructable. + +### Restore +```bash +./deploy.sh +``` + +--- + +## Common Failures +| Symptom | Cause | Fix | +|---------|-------|-----| +1. Service not available | Incorrect DNS entry | Check Caddy reverse proxy configuration and DNS resolution. +2. Data corruption | Inconsistent backups | Ensure consistent and regular backups of critical data volumes. +3. Network connectivity issues | Incorrect network configuration | Verify network configuration and re-deploy the stack with corrected settings. + +--- + +## Changelog + +| Date | Commit | Summary | +|------|--------|---------| +| 2026-04-03 | e5ba5297 | Initial deployment documentation. +| 2026-04-03 | 74b54de4 | Minor configuration updates. +| 2026-04-03 | 4f400b3f | Security patches and bug fixes. +| 2026-04-03 | 8df1f14f | Performance improvements. +| 2026-04-03 | 99cffc2b | Minor documentation updates. + +--- + +## Notes +- Generated by Gremlin on 2026-04-04T01:35:32.755Z +- Source: swarm/bazarr.yaml +- Review User Guide and Changelog sections \ No newline at end of file