This guide walks you through fixing an Ubuntu printer that shows up in the system but refuses to print. You’ll clear stuck jobs, reset the print queue, reinstall drivers, and check common configuration issues—without needing a terminal unless you want one.
What You’ll Need
- Your printer’s model name (usually printed on the front or in the manual)
- Access to the printer’s power cable and USB or network connection
- Administrator (sudo) access to your Ubuntu system
- Internet connection for downloading drivers if needed
Step-by-Step
- Check the obvious first. Ensure the printer is powered on, has paper, and isn’t showing an error light. If it’s a network printer, confirm it’s on the same Wi-Fi or Ethernet network as your computer.
- Look at the job queue. Open Settings → Printers. Click your printer, then select Print Queue or Jobs. If you see stuck jobs with an error, click Cancel on each one. A single hung job can block everything behind it.
- Restart the print service. Open a terminal (Ctrl+Alt+T) and run:
sudo systemctl restart cups
This restarts the Common Unix Printing System, which handles all printing on Ubuntu. It’s the most common fix for a printer that’s detected but won’t respond.
- Clear the print queue completely. In the terminal, run:
sudo cancel -a
This cancels all jobs. Then check if the queue is empty with
lpstat -o. If it still shows jobs, you may need to delete the queue files:sudo rm -f /var/spool/cups/*
Then restart CUPS again with
sudo systemctl restart cups. - Verify the printer is set as default. In Settings → Printers, right-click your printer and select Set as Default. If multiple printers exist, a job may be going to the wrong one.
- Check the connection type. For USB printers, unplug and replug the cable. For network printers, note the IP address from the printer’s display or network settings page. Then in Ubuntu, go to Settings → Printers, click your printer, and select Printer Details to verify the URI matches (e.g.,
ipp://192.168.1.50orsocket://192.168.1.50:9100). - Reinstall the printer driver. Go to Settings → Printers, select the printer, and click Remove. Then click Add a Printer. Ubuntu will search for it. Choose the model from the list if it appears, or select Provide PPD File if you downloaded a driver from the manufacturer’s website. Follow the prompts to re-add it.
- Try a different driver. If the default driver isn’t working, in Printer Details click Change Driver. Select a generic driver like Generic → PostScript or Generic → Text-Only as a test. If that prints, you know the original driver was the problem.
- Test with a basic file. Print a simple text file or a test page (in Printer Details, click Print Test Page). Avoid complex PDFs or graphics initially—they can mask driver issues.
- Check for firmware updates. Some printers have firmware that can be updated via the printer’s web interface (type its IP in a browser) or the manufacturer’s utility. An outdated firmware can cause communication failures.
Common Mistakes
- Forgetting to restart CUPS after changes. Many fixes require a service restart to take effect. Always run
sudo systemctl restart cupsafter changing drivers or queue settings. - Using the wrong network URI. A printer may be detected via mDNS but the stored URI might be stale. Double-check the IP address and protocol.
- Ignoring the printer’s own error state. If the printer shows a paper jam or low ink, it won’t accept new jobs even if Ubuntu sees it.
- Assuming the default driver is correct. Ubuntu often picks a generic driver that works for basic functions but fails on specific models. Always try the manufacturer’s driver if available.
- Not clearing all stuck jobs. A single failed job can block the queue. Use
sudo cancel -aand verify withlpstat -o.
Tips
- Use the Print Test Page feature after any change—it’s the fastest way to confirm the basic connection works.
- For network printers, assign a static IP in your router’s DHCP settings to prevent address changes that break the connection.
- Keep your system updated:
sudo apt update && sudo apt upgrade. CUPS and driver packages are frequently patched. - If you’re using a USB hub, try connecting the printer directly to a computer USB port. Hubs can cause intermittent communication issues.
- Check the printer’s web interface (if it has one) for error logs—they often give a more precise reason than Ubuntu does.
Troubleshooting
If the steps above don’t solve it, try these in order:
- Check CUPS error log. Run
sudo tail -f /var/log/cups/error_login the terminal, then attempt a print. Look for lines containing “Unable to connect”, “Authentication”, or “Filter failed”. This will often point to the exact problem. - Try a different connection method. If using USB, switch to network (or vice versa). This isolates whether the issue is hardware or configuration.
- Disable IPv6. Some printers have trouble with IPv6. In Printer Details, change the URI from
ipp://[ipv6...]toipp://192.168.x.x(IPv4). - Install a PPD from the manufacturer. Go to the printer manufacturer’s support site, download the Linux driver (usually a .deb or .ppd file), and install it. This often resolves compatibility issues that generic drivers miss.
- Use the command line to print. Run
lp -d printer_name /path/to/file.txt. If this works but the GUI doesn’t, the issue is in the desktop environment’s print dialog, not the printer itself. - Check for firewall interference. If you have a firewall enabled, ensure it allows CUPS (port 631) and mDNS (port 5353). You can temporarily disable it with
sudo ufw disableto test, then re-enable withsudo ufw enable.
Frequently Asked Questions
Why does Ubuntu detect my printer but say “Idle – File “file.pdf” contains errors”?
This usually means the driver is misconfigured or the file is corrupted. Try printing a test page first. If that works, the file is the issue. If not, reinstall the driver.
My printer is connected via USB but doesn’t show up in CUPS. What should I do?
Check if the system sees it with lsusb in the terminal. If it appears, run sudo systemctl restart cups and then try adding it again. If it doesn’t appear, try a different cable or port.
How do I find my printer’s IP address on Ubuntu?
Go to Settings → Printers, click your printer, and select Printer Details. The URI will show the IP. You can also check your router’s connected devices list.
Can I use a Windows driver on Ubuntu?
No, Windows drivers are not compatible. However, many printers support the standard PostScript or PCL languages, so a generic driver often works. Check the manufacturer’s website for Linux-specific drivers.
Why does my printer work on Windows but not on Ubuntu?
This is usually a driver issue. Windows has proprietary drivers, while Ubuntu relies on open-source or manufacturer-provided Linux drivers. Installing the correct Linux driver should fix it.
What does “Filter failed” mean in the CUPS error log?
It means the driver (filter) couldn’t process the file. This can be due to a corrupted driver, missing dependencies, or an unsupported file format. Reinstall the driver or try a different one.
Related
General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.
More in this bed
- Autoplay Not Working on Windows 11? Fix It
- Edit Messages on iPhone & View Edit History
- How to Clean Rust Off Chrome Dinette Legs
- How to Add Another Account on Telegram
- Prepare Your PC for a Major Windows Upgrade
- How to Check Where an HP Laptop or PC Was Made