FAQ

Codec: HEVC
Encoder: NVIDIA NVENC (hevc_nvenc)

docker run -d \
  -e ROLE=main \
  -e DATABASE_URL=postgresql://user:pass@localhost:5432/bitbonsai \
  -p 3100:3100 \
  bitbonsai/backend

docker run -d \
  -e ROLE=linked \
  -e MAIN_NODE_URL=http://192.168.1.100:3100 \
  -v /mnt/shared:/media \
  bitbonsai/backend

ffmpeg -i input.mkv \
  -c:v libx265 \
  -crf 20 -preset slow \
  -color_primaries bt2020 \
  -color_trc smpte2084 \
  -colorspace bt2020nc \
  -x265-params "hdr-opt=1:repeat-headers=1" \
  output.mkv

# Full backup
docker exec bitbonsai-postgres pg_dump -U bitbonsai > backup.sql

# Restore
docker exec -i bitbonsai-postgres psql -U bitbonsai < backup.sql

# Stop containers
docker-compose down

# Backup data volume
tar -czf bitbonsai-data.tar.gz /var/lib/docker/volumes/bitbonsai_postgres_data

# Restore
tar -xzf bitbonsai-data.tar.gz -C /
docker-compose up -d

# Add to crontab (daily at 2 AM)
0 2 * * * docker exec bitbonsai-postgres pg_dump -U bitbonsai | gzip > /backups/bitbonsai-$(date +\%Y\%m\%d).sql.gz

# Install WSL2
wsl --install

# Install Docker Desktop (with WSL2 backend)
# Download from: https://docker.com/desktop

# Run BitBonsai
docker-compose up -d

# /etc/exports
/mnt/media 192.168.1.0/24(rw,sync,no_subtree_check,no_root_squash)

# Restart NFS
exportfs -ra
systemctl restart nfs-server

# Mount NFS share
mount -t nfs -o vers=4,rw 192.168.1.100:/mnt/media /media

# Auto-mount on boot (fstab)
echo "192.168.1.100:/mnt/media /media nfs vers=4,rw 0 0" >> /etc/fstab

# Increase NFS read/write size (performance boost)
mount -t nfs -o vers=4,rw,rsize=1048576,wsize=1048576 \
  192.168.1.100:/mnt/media /media

Access: http://YOUR_IP:4200
Features:
- Real-time job progress (%)
- Live FFmpeg output logs
- Queue status and ETA
- Responsive design (works on phones)

# Get all jobs
curl http://YOUR_IP:3100/api/jobs

# Get specific job
curl http://YOUR_IP:3100/api/jobs/123

# Get encoding stats
curl http://YOUR_IP:3100/api/statistics

// Connect to WebSocket
const ws = new WebSocket('ws://YOUR_IP:3100');

ws.onmessage = (event) => {
  const { jobId, progress, status } = JSON.parse(event.data);
  console.log(`Job ${jobId}: ${progress}% - ${status}`);
};

server {
  listen 443 ssl;
  server_name bitbonsai.yourdomain.com;

  location / {
    proxy_pass http://localhost:4200;
  }

  location /api {
    proxy_pass http://localhost:3100;
  }
}

# Pause at 8 AM
0 8 * * * curl -X POST http://localhost:3100/api/queue/pause-all

# Resume at 6 PM
0 18 * * * curl -X POST http://localhost:3100/api/queue/resume-all

# docker-compose.yml
services:
  backend:
    cpus: '2.0'  # Limit to 2 cores