docs: add Docker testing setup and instructions
Some checks are pending
Seerr CI / i18n Check (push) Waiting to run
Seerr CI / Lint & Test Build (push) Waiting to run
Seerr CI / Build (per-arch, native runners) (amd64, linux/amd64, ubuntu-24.04) (push) Waiting to run
Seerr CI / Build (per-arch, native runners) (arm64, linux/arm64, ubuntu-24.04-arm) (push) Waiting to run
Seerr CI / Publish multi-arch image (push) Blocked by required conditions
Seerr CI / Send Discord Notification (push) Blocked by required conditions
CodeQL / Analyze (actions) (push) Waiting to run
CodeQL / Analyze (javascript) (push) Waiting to run
Merge Conflict Labeler / Labeling (push) Waiting to run

This commit is contained in:
Synapse
2026-02-21 01:08:28 +00:00
parent c2fe0fdc95
commit 83843bb6c8
2 changed files with 97 additions and 0 deletions

62
README-TESTING.md Normal file
View File

@@ -0,0 +1,62 @@
# Testing Channels-Seerr with Docker
## Quick Start
1. **Build and run:**
```bash
docker-compose -f docker-compose.test.yml up --build
```
2. **Access the web UI:**
- Open browser: http://localhost:5055
- Complete the setup wizard
- Add your Channels DVR server in Settings
3. **Stop:**
```bash
docker-compose -f docker-compose.test.yml down
```
## Configuration
- **Config directory:** `./config` (created automatically, persists settings)
- **Logs:** `docker-compose logs -f seerr`
- **Port:** Default 5055 (change in docker-compose.test.yml if needed)
## Testing Channels DVR Integration
1. Start Seerr container
2. Navigate to Settings → Channels DVR
3. Add your Channels DVR server:
- **Server URL:** http://your-channels-server:8089
- **Test connection** to verify
4. Enable sync jobs (manual or scheduled)
5. Check logs for sync activity:
```bash
docker-compose -f docker-compose.test.yml logs -f seerr | grep -i channels
```
## Development Testing
For faster iteration without full rebuilds:
```bash
# Use Dockerfile.local for development
docker build -f Dockerfile.local -t channels-seerr:dev .
docker run -p 5055:5055 -v ./config:/app/config channels-seerr:dev
```
## Troubleshooting
**Build fails:**
- Check Node.js version (requires 22.x)
- Try: `docker-compose -f docker-compose.test.yml build --no-cache`
**Can't connect to Channels DVR:**
- If Channels is on host machine: Use `http://host.docker.internal:8089`
- If on tailnet: Use the Tailscale IP
- Check firewall allows connections from Docker network
**Database issues:**
- SQLite (default): Stored in `./config/db/db.sqlite3`
- To use Postgres: Uncomment postgres service in docker-compose.test.yml

35
docker-compose.test.yml Normal file
View File

@@ -0,0 +1,35 @@
version: '3.8'
services:
seerr:
build:
context: .
dockerfile: Dockerfile
args:
COMMIT_TAG: channels-dvr-test
container_name: channels-seerr-test
hostname: seerr
ports:
- "5055:5055"
environment:
- LOG_LEVEL=debug
- TZ=America/Chicago
volumes:
- ./config:/app/config
restart: unless-stopped
# Optional: PostgreSQL for production-like testing
# Uncomment if you want to test with Postgres instead of SQLite
# postgres:
# image: postgres:15-alpine
# container_name: seerr-postgres
# environment:
# - POSTGRES_PASSWORD=seerr
# - POSTGRES_USER=seerr
# - POSTGRES_DB=seerr
# volumes:
# - postgres-data:/var/lib/postgresql/data
# restart: unless-stopped
# volumes:
# postgres-data: