Public | Automated Build

Last pushed: 10 months ago
Short Description
docker container to share a USB printer on LAN with cups
Full Description

Current version

CUPS 2.2.1

What is CUPS?

CUPS is an open source printing system that supports IPP along with other protocols. More information can be found at

About this image

This image is based off ticosax/cups-in-docker with a few specific tweaks:

  • Debian testing is used as the base image. Most of the cups updates are put into testing fairly quickly so no need for unstable. This may change in future if versions start lagging behind.
  • Adds USB backend for Brother printer.

Running this image

Way 1 : docker run

docker run -e CUPS_USER_ADMIN=admin \
-p 631:631/tcp \
-v /path/to/cupsd.conf:/etc/cups/cupsd.conf \
--device=/dev/bus/usb/xxx/yyy \

Way 2 : docker compose

See provided docker-compose.yml file.
Don't forget to set the PRINTER_ADDRESS var and change the PRINTER_MODEL value according to your model of Brother printer.

Way 3 : startup script

The provided startup script automatically gets the printer address /dev/bus/usb/xxx/yyy by looking at
any Brother printer matching the provided VID (USB vendor ID) and PID (USB product ID).
Don't forget to change the PRINTER_MODEL, PRINTER_VID and PRINTER_PID values according to your model of Brother printer.

To get the information about the correct VID and PID, one could check the available lists online (ex :, or
Also you can use the provided script which output the VID and PID for any connected Brother USB printer.

Access the CUPS server at
To access it remotely at http://server-ip:631, add the line DefaultEncryption IfRequested to cupsd.conf.

Docker Pull Command
Source Repository