aguslr/docker-cups⁠

This Docker image sets up CUPS inside a docker container.

Installation

To use docker-cups, follow these steps:

1. Download your printer drivers in DEB format into a directory named ./drivers.

2. Clone and start the container:

   docker run --privileged -p 631:631 \
     -e CUPS_USER=admin \
     -e CUPS_PASS=admin \
     -v /dev/bus/usb:/dev/bus/usb \
     -v /run/dbus:/run/dbus \
     -v "${PWD}"/drivers:/opt/drivers \
     docker.io/aguslr/cups:latest
   

   Copy

3. Open http://127.0.0.1:631⁠ with your web browser to access CUPS.

Variables

The image is configured using environment variables passed at runtime. All these variables are prefixed by CUPS_.

To see the default autogenerated password, check the log for the container:

docker logs <container_name> | grep '^Password'

Build locally

Instead of pulling the image from a remote repository, you can build it locally:

1. Clone the repository:

   git clone https://github.com/aguslr/docker-cups.git
   

   Copy

2. Change into the newly created directory and use docker-compose to build and launch the container:

   cd docker-cups && docker-compose up --build -d
   

   Copy