125 lines
No EOL
3 KiB
Markdown
125 lines
No EOL
3 KiB
Markdown
---
|
|
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 |