Skip to content

Latest commit

 

History

History
57 lines (42 loc) · 2.83 KB

README.md

File metadata and controls

57 lines (42 loc) · 2.83 KB

CUPS print server image

Overview

Docker image including CUPS print server and printing drivers (installed from the Debian packages).

Run the Cups server

Using the default cupsd.conf configuration file:

docker run -d -p 631:631 -v /var/run/dbus:/var/run/dbus --name cupsd olbat/cupsd

Using a custom cupsd.conf configuration file:

docker run -d -p 631:631 -v /var/run/dbus:/var/run/dbus -v $PWD/cupsd.conf:/etc/cups/cupsd.conf --name cupsd olbat/cupsd`

Note: the following mount can be added to configure a printer connected through USB -v /dev/bus/usb:/dev/bus/usb see #103 (comment)

Note (bis): if the daemon fails to start with a cupsdDoSelect() failed error, you can fix the issue by adjusting the container's ulimit configuration, see #111 (comment)

Add printers to the Cups server

  1. Connect to the Cups server at http://127.0.0.1:631
  2. Add printers: Administration > Printers > Add Printer

Note: The admin user/password for the Cups server is print/print

Configure Cups client on your machine

  1. Install the cups-client package
  2. Edit the /etc/cups/client.conf, set ServerName to 127.0.0.1:631
  3. Test the connectivity with the Cups server using lpstat -r
  4. Test that printers are detected using lpstat -v
  5. Applications on your machine should now detect the printers!

Included package

  • cups, cups-client, cups-filters
  • foomatic-db
  • printer-driver-all, printer-driver-cups-pdf
  • openprinting-ppds
  • hpijs-ppds, hp-ppd
  • sudo, whois
  • smbclient

Troubleshooting

This Dockerfile can be used to build an image is containing most of the printing drivers packaged by Debian's team and allows to run a CUPS daemon to create a remote print server.

Now, this is as good as it gets! This repository has nothing to do with maintaining/debugging/supporting printer drivers packaged in Debian or the CUPS service.

If you need support on those topics, please try to reach out to the relevant support channels:

If you have some questions about how to start the container, make it accessible through your local network, run it on your NAS, etc. again, this is not the good place to ask them.

In that case, please reach out to the relevant support channels. If you have an issue related to Docker's networking, I also strongly advise you to have a look at Docker's documentation page on that topic to get a good grasp on the main concepts in play.