What is a job? A job is a single video file being encoded. Each video in your library becomes
one job. See glossary for more details.
Job Lifecycle
| Status | Description | What Happens Next |
|---|---|---|
| DETECTED | File found during library scan | Health check runs automatically |
| HEALTH_CHECK | Validating file integrity | Moves to NEEDS_DECISION or FAILED |
| NEEDS_DECISION | Waiting for user to queue | User selects codec and queues |
| QUEUED | Waiting for worker node | Starts encoding when node available |
| TRANSFERRING | (Multi-node only) Copying to worker | Starts encoding after transfer |
| ENCODING | Currently being encoded | Progress updates in real-time |
| PAUSED | User paused encoding | Resumes when user clicks Resume |
| VERIFYING | Checking output file health | Moves to COMPLETED or FAILED |
| COMPLETED | Successfully encoded | Original backed up, file replaced |
| FAILED | Encoding error occurred | Auto-retries 3x, then stops |
| CORRUPTED | File failed health check or verification | Hourly auto-requeue for re-validation |
| CANCELLED | User cancelled job | Removed from queue |
Lifecycle Flow Diagram
Most jobs go: DETECTED → HEALTH_CHECK → NEEDS_DECISION → QUEUED → ENCODING →
VERIFYING → COMPLETED. The whole process is automatic after you click “Queue Selected.”
Job Status Details
For detailed information about each job status, see Job Status Reference.Auto-Healing
BitBonsai includes multiple self-healing mechanisms. See Auto-Healing Features.Troubleshooting
Common job issues and solutions:- Job stuck in QUEUED
- Job stuck in ENCODING at 0%
- Job failed with “Disk Full”
- Job failed with “Source Corrupted”
- Completed job but file still H.264
Related Guides
- Add Your First Library - Scan and queue videos
- Monitoring Progress - Track encoding stats
- Multi-Node Setup - Scale encoding with workers
- Troubleshooting - Fix common issues