olbat/cupsd repository overview

Note: this image is built from https://github.com/olbat/dockerfiles/tree/master/cupsd⁠

⁠Overview

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

Images are available for the amd64 and arm64 architectures.

⁠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 image contains 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! The repository that contains the Dockerfile to build this image 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 rather than opening issues on the GitHub repository associated to this image.

Here are some pointers:

• Debian forums⁠
• Debian "printing" team⁠
• cups mailing list⁠
• or one of the many other options you could easily find using your favorite search engine!

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, the GitHub repository of this image 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.