docs(gremlin): create bazarr

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