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
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:
62
README-TESTING.md
Normal file
62
README-TESTING.md
Normal 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
35
docker-compose.test.yml
Normal 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:
|
||||
Reference in New Issue
Block a user