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…
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
Variants
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
- airprint not working consistently - Raspberry Pi Forums (forum)
- CUPS Printing From Android : r/selfhosted - Reddit (reddit)
- CUPS - AirPrint - Blank pages - Raspberry B - Raspberry Pi Forums (forum)
- Getting AirPrint/Bonjour to work on CUPS : r/sysadmin - Reddit (reddit)
- CUPS and Airprint server - Updated : r/RASPBERRY_PI_PROJECTS - Reddit (reddit)
Collected 53 days ago - public community threads