Cups-Airprint

A Dockerized CUPS (Common Unix Printing System) instance that acts as an AirPrint relay, letting iOS and macOS devices and other AirPrint-capable clients…

  • Network Services
  • Tools & Utilities
A Dockerized CUPS (Common Unix Printing System) instance that acts as an AirPrint relay, letting iOS and macOS devices and other AirPrint-capable clients print to network or USB printers that are already on the network but lack native AirPrint support.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

56/100 Fair

Maintained
62last commit 157 days ago
Popular
47221 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
75no serious findings

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 53 days ago

GitHub stars
221
Open issues
3
Last commit
2026-06-17
Latest release
v1.2.1
License
GPL-3.0
Activity
stale

Checked 20 days ago - source: GitHub (chuckcharlie/cups-avahi-airprint)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install an HTTPS certificate if you need it If you want secure (HTTPS) printing, run the cups-x509 install command with your server name and the PEM certificate file. The name and certificate must match, or the secure web interface can fail. source
  • Default admin credentials The CUPS Web UI defaults to admin/admin; change this password when setting up the container. source
  • Adding printers Add printers in the Web UI under Administration → Printers → Add Printer, then mark each printer as shared so CUPS advertises it on the network via Avahi. source

Fetched 37 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

What must I change when upgrading from a pre-v2.0 image?

Remove any bind mount from the host /var/run/dbus directory into the container. Since v2.0 the container runs its own dbus-daemon and can clobber the host D-Bus socket, which may break host services until the container is removed.

What data should I persist or back up?

Use the /config volume because it stores the persistent CUPS printer configuration. It also contains /config/ssl with the self-signed TLS certificate and private key, so keep that volume private.

Why does it require host networking, and what security impact does that have?

Host networking is required for the multicast used by AirPrint discovery. It exposes the CUPS web admin and printing on port 631 to the LAN, accepts print jobs without authentication, and traffic is not meaningfully encrypted, so run it only on a trusted network.

How do I avoid mDNS hostname conflicts or run more than one instance?

Set AVAHI_HOSTNAME to a unique mDNS hostname instead of the default cups-airprint. This is useful when running multiple instances or when the default name conflicts with the host’s own mDNS daemon, which is common on NAS devices.

How do I configure the CUPS admin account?

Set the CUPSADMIN environment variable for the admin user and CUPSPASSWORD for its password. If left unset, CUPSADMIN defaults to cupsadmin and CUPSPASSWORD defaults to the same value as CUPSADMIN.

Answers sourced from github.com

Community

Collected 53 days ago - public community threads