# cups-avahi-airprint

> Self-hosted Docker image that runs CUPS with Avahi to make network printers discoverable via AirPrint on iOS and macOS devices.

- **Category:** Device Management
- **Licence:** GPL-3.0
- **Latest version:** v1.2.1
- **Open source:** oss
- **Languages:** Shell, Dockerfile
- **Platforms:** Docker Compose
- **Tags:** iOS, Docker, macOS, Mdns, Printing, Printer, Cups, Avahi, Airprint, DNS Sd

## Description

This Alpine-based Docker container runs a CUPS printing server paired with Avahi to advertise printers via mDNS/DNS-SD. It bridges non-AirPrint network printers so they appear automatically on iPhones, iPads, and Macs. A built-in script creates Apple configuration profiles that let devices print over direct IPP connections, useful across VLANs or VPN tunnels. The container requires host networking for multicast discovery and serves its web admin on port 631. Settings such as admin credentials, advertised hostname, and timezone come from environment variables. Printer definitions and self-signed certificates persist in a mounted /config directory. The codebase originated as a fork of quadportnick/docker-cups-airprint.

## Links

- [Homepage](https://github.com/chuckcharlie/cups-avahi-airprint)
- [Docker](chuckcharlie/cups-avahi-airprint)
- [GitHub Repository](https://github.com/chuckcharlie/cups-avahi-airprint)
- [Docker Hub](https://hub.docker.com/r/chuckcharlie/cups-avahi-airprint)

---
Source: https://selfhost.directory/project/cups-avahi-airprint