OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
apps-services medium common DISPUTE

Fix CUPS "client-error-document-format-not-supported" / "Filter failed"

archomarchyendeavouroscachyosmanjarocupsprinting
CORRECTED An auditor found the fix wrong or incomplete and rewrote it.
AUDIT NOTE

The fix is broadly right (install the filter chain, raise LogLevel, re-enable the queue, re-add as driverless -m everywhere), cups-filters, ghostscript, gsfonts and foomatic-db* all exist in extra, and the LogLevel warning is a good catch. The cause is wrong on one point that changes what a reader installs: cups-pdf is not part of the print pipeline at all. It is a backend that adds a virtual 'PDF' printer writing files to ~/PDF. Missing cups-pdf cannot cause client-error-document-format-not-supported or 'Filter failed' on a real printer. The conversion chain is cups-filters (plus libcupsfilters/libppd on current Arch) with ghostscript/gsfonts behind it.

The cause above was not rewritten and may still contain the error described. The fix below is the corrected version.
RISK

Remember to set LogLevel back to warn in /etc/cups/cupsd.conf afterwards. Debug logging fills /var/log/cups/ quickly on a busy machine.

Symptom

The printer is added and shows as Idle, but every job instantly errors with:


Print-Job client-error-document-format-not-supported

or the queue stops with "Filter failed" and the job disappears.

Cause

CUPS has deprecated classic PPD drivers in favour of IPP Everywhere / driverless printing, which sends PDF to the printer. When the printer needs a conversion step, that work is done by the cups-filters chain (cups-filters, and on current Arch libcupsfilters/libppd) backed by ghostscript/gsfonts. If those are missing, or a legacy PPD was selected for a printer that has no matching filter, CUPS reports the job as an unsupported document format or stops the queue with 'Filter failed'. (cups-pdf is unrelated: it only adds a virtual PDF printer.)

Fix

Install the actual filter chain:


sudo pacman -S cups cups-filters ghostscript gsfonts
sudo systemctl restart cups.service

(cups-pdf is optional and only gives you a virtual PDF printer. Install it if you want that, not to fix this error.) For non-IPP-Everywhere printers needing a legacy PPD, add foomatic-db foomatic-db-engine foomatic-db-nonfree as written.

The rest is correct as written: LogLevel debug in /etc/cups/cupsd.conf + tail -f /var/log/cups/error_log to read the real failure (then set it back to warn), cupsenable/cupsaccept to restart the queue, and lpadmin -x / lpadmin -p ... -m everywhere to re-add it driverless. Run the lpadmin/cupsenable/cupsaccept commands with administrative rights.

Verify

lp -d MyPrinter /usr/share/cups/data/testprint produces a page, and lpstat -W completed -o shows the job as completed rather than held.

Sources

cups-document-format-not-supported