nikdoof/cups-avahi-airprint
1
0
Fork 0
mirror of https://github.com/nikdoof/cups-avahi-airprint.git synced 2025-12-11 22:52:21 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
d2aa0938f90895d9d53a9c3de3869f89f310b73f
cups-avahi-airprint/README.md
Thomas Schewe d2aa0938f9 Add defaults for CUPSADMIN and CUPSPASSWORD 
If the variables CUPSADMIN and/or CUPSPASSWORD are not provided on start
adding the cups admin will fail, but the container will nevertheless
start.

With this change CUPSADMIN - if missing - will be set to "cupsadmin" and
CUPSPASSWORD - if missing - will be set to the name of the cups admin.
2020-05-03 19:37:24 +02:00

1.6 KiB
Raw Blame History

chuckcharlie/cups-avahi-airprint

Fork from quadportnick/docker-cups-airprint

This Alpine-based Docker image runs a CUPS instance that is meant as an AirPrint relay for printers that are already on the network but not AirPrint capable. The other images out there never seemed to work right. I forked the original to use Alpine instead of Ubuntu and work on more host OS's.

Configuration

Volumes:

  • /config: where the persistent printer configs will be stored
  • /services: where the Avahi service files will be generated

Variables:

  • CUPSADMIN: the CUPS admin user you want created
  • CUPSPASSWORD: the password for the CUPS admin user

If CUPSADMIN is not set, the default "cupsadmin" will be used. If CUPSPASSWORD is no set, the name of the admin user will be used.

Ports/Network:

  • Must be run on host network. This is required to support multicasting which is needed for Airprint.

Example run command:

docker run --name cups --restart unless-stopped  --net host\
  -v <your services dir>:/services \
  -v <your config dir>:/config \
  -e CUPSADMIN="<username>" \
  -e CUPSPASSWORD="<password>" \
  chuckcharlie/cups-avahi-airprint:latest

Add and set up printer:

  • CUPS will be configurable at http://[host ip]:631 using the CUPSADMIN/CUPSPASSWORD.
  • Make sure you select Share This Printer when configuring the printer in CUPS.
  • After configuring your printer, you need to close the web browser for at least 60 seconds. CUPS will not write the config files until it detects the connection is closed for as long as a minute.