Skip to main content

Network & Remote Access

BitBonsai provides multiple monitoring options:1. Web UI (Mobile-Friendly)
Access: http://YOUR_IP:4210
Features:
- Real-time job progress (%)
- Live FFmpeg output logs
- Queue status and ETA
- Responsive design (works on phones)
2. API EndpointsGet your JWT token from the browser developer tools (F12 → Application → Local Storage → token).
# Get all jobs
curl -H "Authorization: Bearer YOUR_JWT_TOKEN" http://YOUR_IP:3100/jobs

# Get specific job
curl -H "Authorization: Bearer YOUR_JWT_TOKEN" http://YOUR_IP:3100/jobs/123

# Get encoding stats
curl -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  http://YOUR_IP:3100/insights/stats
3. WebSocket (Real-Time Updates)
// 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}`);
};
4. Notifications (Planned)
  • Email alerts on job completion/failure
  • Discord webhooks
  • Pushover/Telegram integration
Mobile Access:
  • Enable port forwarding (3100, 4210)
  • Use VPN for secure remote access (Tailscale, WireGuard)
  • Or reverse proxy with SSL (Nginx, Caddy)
Example: Nginx Reverse Proxy
server {
  listen 443 ssl;
  server_name bitbonsai.yourdomain.com;

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

  location /api {
    proxy_pass http://localhost:3100;
  }
}
See Monitoring Guide for dashboards.