Skip to main content

Log Locations

Access logs for debugging:
Add -f flag to follow logs in real-time: docker compose logs -f bitbonsai-backend

Full System Reset (Nuclear Option)

This will delete all job history and settings. Use only as last resort.

Database Backup & Restore

Backup:
Restore:

Reset Stuck Jobs (Safe)

Reset all jobs to fresh state without losing configuration:

When to Report Bugs

If you’ve tried the above fixes and still experiencing issues, please report to GitHub:

Report Issue on GitHub

Create a new issue with logs and reproduction steps
Include in your report:
  1. BitBonsai version (docker compose images | grep bitbonsai)
  2. Deployment method (Docker Compose, Unraid, LXC)
  3. Node configuration (single vs. multi-node)
  4. Full error logs (use docker compose logs --tail=100 bitbonsai-backend)
  5. Steps to reproduce the issue
  6. Expected vs. actual behavior

Next Steps

Advanced Debugging

Enable debug logging, monitor resources, network debugging

Common Errors

Fix specific error messages and issues