Ubuntu 26.04 LTS – CUPS print queue stuck with jobs not processing – Fix & Prevention

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution – Primary Fix
7. Solution – Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

Print jobs remain pending or stopped, blocking document workflows.

Environment & Reproduction

Appears after printer firmware changes, backend errors, or stale job spool files.

systemctl status cups
lpstat -t
lpstat -W not-completed

Root Cause Analysis

Queue backend hangs or malformed job data blocks subsequent jobs in the same queue.

Quick Triage

Check queue state, default printer, and CUPS logs.

lpstat -p -d
sudo tail -n 120 /var/log/cups/error_log
ls -l /var/spool/cups | head

Step-by-Step Diagnosis

Identify failing backend path and specific job causing blockage.

sudo cupsenable -v 
sudo cupsaccept 
lpoptions -p  -l

Solution – Primary Fix

Cancel stuck jobs, restart CUPS, and re-enable queue.

cancel -a
sudo systemctl restart cups
sudo cupsenable 
sudo cupsaccept 

Solution – Alternative Approaches

Recreate printer queue with correct driverless IPP settings.

sudo lpadmin -x 
sudo lpadmin -p  -E -v ipp:///ipp/print -m everywhere

Verification & Acceptance Criteria

Test job prints successfully and queue no longer stalls.

echo 'test page' | lp -d 
lpstat -t

Rollback Plan

Restore previous queue configuration backup if new driverless setup is incompatible.

sudo cp /etc/cups/printers.conf.bak /etc/cups/printers.conf 2>/dev/null || true
sudo systemctl restart cups

Prevention & Hardening

Monitor queue error rates and keep printer firmware and CUPS packages current.

lpstat -t
sudo apt update
sudo apt install -y --reinstall cups

Related Errors & Cross-Refs

Related to DNS printer discovery failures, TLS certificate issues, and stale spool files.

Related tutorial: View the step-by-step tutorial for Ubuntu 26.04 LTS.

View all Ubuntu 26.04 LTS tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Ubuntu CUPS administration and printer troubleshooting references.