====== Printer Support ======

First we need to download **CUPS**. **CUPS** is the **print management system** that lets your computer talk to printers — whether they’re plugged in via USB or connected over a network.

On the tabletop:

<code bash>
sudo apt update
sudo apt install cups cups-bsd
sudo usermod -a -G lpadmin folk
</code>

(''cups-bsd'' provides the ''lpr'' command that we use to print.)

----


===== Accessing the CUPS Web UI =====

To access the CUPS interface, create an SSH tunnel from your laptop:

<code bash>
ssh -L 6310:localhost:631 folk@folk-WHATEVER.local
</code>

Leave this terminal window open.

Then open your browser and go to:

**http://localhost:6310**

→ Go to **Printers**.  
If your printer shows up automatically, try printing a test page.

//I could not get that ''implicitclass:////'' automatically-added printer in CUPS to work for my printer at all, so I did the below:
//


If the job is paused due to a ''cups-browsed'' issue or otherwise doesn’t work, try the fix mentioned here:  
[[https://askubuntu.com/questions/1128164/no-suitable-destination-host-found-by-cups-browsed|AskUbuntu: No suitable destination host found by cups-browsed]]
 
Remove ''cups-browsed'' by ''sudo apt-get purge --autoremove cups-browsed'' then add printer manually via IPP in Add Printer in Administration tab of CUPS Web UI (it might automatically show up under Discovered Network Printers there using dnssd)

Once printer is working, go to Administration dropdown on printer page and Set as Server Default.

Try printing from Folk!

You can also test printing again with ''lpr ~/folk-printed-programs/SOMETHING.pdf'' (you'll likely have to print the PDF and not the PS for it to work)