# Cups-Airprint

Cups-Airprint is a self-hosted network services app. 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... It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/803/cups-airprint

## Description

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.

## Health score

56/100 (Fair), based on 4 of 5 factors.
- Maintained: 62 (last commit 157 days ago)
- Popular: 47 (221 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 75 (no serious findings)

## Links

- GitHub: https://github.com/chuckcharlie/cups-avahi-airprint
- Docker Hub: https://hub.docker.com/r/chuckcharlie/cups-avahi-airprint
- Unraid: https://ca.unraid.net/apps/cups-airprint-0zvi9x308zka8r?q=Cups-Airprint

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/803/cups-airprint), the self-hosted and open-source app directory.
