encoderPro/DEBUGGING-DOCKER.md

Debugging Docker Container

This guide shows you how to view logs and debug issues in the encoderPro Docker container.

---

Quick Commands

View Live Logs

# Follow logs in real-time (Ctrl+C to stop)
docker logs encoderpro-dashboard-intel -f

# View last 100 lines
docker logs encoderpro-dashboard-intel --tail 100

# View logs with timestamps
docker logs encoderpro-dashboard-intel -f --timestamps

Check Container Status

# Is container running?
docker ps | grep encoderpro

# View all containers (including stopped)
docker ps -a | grep encoderpro

# Inspect container details
docker inspect encoderpro-dashboard-intel

Interactive Debugging

# Open a shell inside the running container
docker exec -it encoderpro-dashboard-intel /bin/bash

# Once inside, you can:
ls /movies          # Check if movies are visible
ls /db              # Check database location
cat /config/config.yaml  # View config
python3 /app/reencode.py -c /config/config.yaml --stats  # Run stats
bash /app/check-gpu.sh  # Check GPU availability
exit                # Exit the container shell

Check AV1 Encoder Support

# Copy test script to container
docker cp test-av1-support.sh encoderpro-dashboard-intel:/app/

# Run AV1 support test
docker exec encoderpro-dashboard-intel bash /app/test-av1-support.sh

---

Enable Debug Mode

Option 1: Environment Variable (Recommended)

Add -e DASHBOARD_DEBUG="true" when creating the container:

docker run -d \
  --name encoderpro-dashboard-intel \
  --device=/dev/dri:/dev/dri \
  -e GPU_TYPE=intel \
  -e DASHBOARD_DEBUG="true" \
  -p 5000:5000 \
  -v /mnt/user/movies:/movies \
  -v /mnt/user/archive/movies:/archive \
  -v /mnt/user/appdata/encoderpro/config.yaml:/config/config.yaml:ro \
  -v /mnt/user/appdata/encoderpro/db:/db \
  -v /mnt/user/appdata/encoderpro/logs:/logs \
  --restart unless-stopped \
  encoderpro-intel:latest dashboard

Option 2: Recreate Container with Debug

# Stop and remove old container
docker stop encoderpro-dashboard-intel
docker rm encoderpro-dashboard-intel

# Start with debug enabled
docker run -d \
  --name encoderpro-dashboard-intel \
  --device=/dev/dri:/dev/dri \
  -e GPU_TYPE=intel \
  -e DASHBOARD_DEBUG="true" \
  -p 5000:5000 \
  -v /mnt/user/movies:/movies \
  -v /mnt/user/archive/movies:/archive \
  -v /mnt/user/appdata/encoderpro/config.yaml:/config/config.yaml:ro \
  -v /mnt/user/appdata/encoderpro/db:/db \
  -v /mnt/user/appdata/encoderpro/logs:/logs \
  --restart unless-stopped \
  encoderpro-intel:latest dashboard

---

Common Issues and Solutions

1. Container Not Starting

# Check why container stopped
docker logs encoderpro-dashboard-intel

# Common causes:
# - Permission errors (fix with chown -R 1000:1000)
# - Missing directories
# - Invalid config.yaml

2. Can't See Processing Logs

# Logs are in multiple places:

# 1. Docker logs (dashboard output)
docker logs encoderpro-dashboard-intel -f

# 2. File logs (reencode.py output)
tail -f /mnt/user/appdata/encoderpro/logs/reencode.log

# 3. Dashboard logs (if configured)
tail -f /mnt/user/appdata/encoderpro/logs/dashboard.log

3. Check If Processing Is Running

# Inside container, check for python processes
docker exec -it encoderpro-dashboard-intel ps aux | grep python

# Check if any files are being processed
docker exec -it encoderpro-dashboard-intel ls -lah /work

4. Database Issues

# Access database directly
docker exec -it encoderpro-dashboard-intel sqlite3 /db/state.db

# Inside SQLite:
SELECT state, COUNT(*) FROM files GROUP BY state;
SELECT * FROM files WHERE state='pending';
SELECT * FROM files WHERE state='processing';
.quit

---

Understanding Log Output

Dashboard Startup Logs

Starting Web Dashboard v3.2.0
Server: http://0.0.0.0:5000
Database: /db/state.db
Config: /config/config.yaml
Debug mode: True
Log level: DEBUG

Processing Logs

============================================================
ENCODERPRO - PHASE 3
Version: 3.0.0
============================================================
Skipping library scan (--no-scan mode)
Processing 1 file(s)...
Processing: movies_7/Get Hard.m4v
Changed output extension to .mp4 for HEVC compatibility
Encoding with INTEL_QSV_H265, profile: sweetspot_qsv

Success Logs

[OK] Completed: movies_7/Get Hard.mp4 | Encoder: INTEL_QSV_H265 | Time: 45.2s | FPS: 58.32 | Saved: 42.3%

Failure Logs

[FAIL] Failed: movies_7/Get Hard.m4v - Encoding failed
FFmpeg error: [error message here]

---

Troubleshooting Workflow

1. Check container is running

   docker ps | grep encoderpro
   

2. View real-time logs

   docker logs encoderpro-dashboard-intel -f
   

3. Select a file in dashboard

   • Open http://your-server:5000
   • Select a file
   • Click "Encode Selected"

4. Watch the logs

   • You should see "Processing 1 file(s)..."
   • Then encoding progress
   • Then either success or failure

5. If nothing happens

   # Check if API calls are reaching the server
   docker logs encoderpro-dashboard-intel --tail 50 | grep "POST /api"
   
   # Check database state
   docker exec -it encoderpro-dashboard-intel sqlite3 /db/state.db "SELECT * FROM files WHERE state='pending';"
   

---

Debug Checklist

• Container is running (docker ps)
• Debug mode enabled (DASHBOARD_DEBUG=true)
• Logs are showing (docker logs -f)
• Can access dashboard (http://your-server:5000)
• Files are scanned (Discovered count > 0)
• Can select files (checkbox works)
• Encode button shows confirmation
• Processing log shows "Processing X file(s)"
• FFmpeg runs without errors
• Encoded file appears in movies directory

---

Performance Monitoring

# Check container resource usage
docker stats encoderpro-dashboard-intel

# Monitor GPU usage (Intel)
intel_gpu_top

# Check disk I/O
iostat -x 1

---

File Locations

What	Location in Container	Location on Host
Dashboard code	/app/dashboard.py	Local build directory
Reencode script	/app/reencode.py	Local build directory
Config file	/config/config.yaml	/mnt/user/appdata/encoderpro/config.yaml
Database	/db/state.db	/mnt/user/appdata/encoderpro/db/state.db
Logs	/logs/	/mnt/user/appdata/encoderpro/logs/
Movies	/movies/	/mnt/user/movies/
Archive	/archive/	/mnt/user/archive/movies/
Work files	/work/	Container temp (lost on restart)

---

Getting Help

When reporting issues, include:

1. Container logs

   docker logs encoderpro-dashboard-intel --tail 200 > logs.txt
   

2. Database state

   docker exec -it encoderpro-dashboard-intel sqlite3 /db/state.db "SELECT state, COUNT(*) FROM files GROUP BY state;" > db-state.txt
   

3. System info

   docker version > sysinfo.txt
   uname -a >> sysinfo.txt
   lspci | grep -i vga >> sysinfo.txt
   

4. Config file (remove sensitive paths if needed)

   cat /mnt/user/appdata/encoderpro/config.yaml > config.txt