sodcalculator

10 Tech How-To

Ubuntu Printer Detected But Won’t Print: Fix

Guide 10-52609 · Updated · Step by step

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

  1. 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.
  2. 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.
  3. 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.

  4. 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.

  5. 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.
  6. 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.50 or socket://192.168.1.50:9100).
  7. 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.
  8. 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.
  9. 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.
  10. 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 cups after 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 -a and verify with lpstat -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_log in 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...] to ipp://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 disable to test, then re-enable with sudo 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

The whole Tech How-To bed →