selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
cups-avahi-airprint logo

Self-host cups-avahi-airprint

v1.2.1

Docker image for CUPS AirPrint relay

ReleaseOpen SourceGPL-3.0
Updated4 months ago
LanguageShell
Setup difficultyModerate
Stars
221
Ports
631 (CUPS web admin and IPP printing), 5353 (mDNS/DNS-SD (Avahi) for AirPrint discovery)
Docker
chuckcharlie/cups-avahi-airprint
Install with Docker Compose

What is cups-avahi-airprint?

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.

Should you self-host cups-avahi-airprint?

cups-avahi-airprint scores 47/100 on selfhost.directory (how scoring works) and ranks #7 of 11 in Device Management. It has 221 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is GPL-3.0-licensed and written mostly in Shell.

Its closest alternative on selfhost.directory is Fleet (67/100, 7 064 stars). It scores higher overall, so compare the two before you pick. See cups-avahi-airprint vs Fleet side by side.

Features

  • AirPrint relay
  • Automatic printer discovery
  • Configuration Profile Generator
  • Persistent configuration
  • Web-based administration

cups-avahi-airprint README

How to install cups-avahi-airprint

Install cups-avahi-airprint with Docker Compose

Environment variables
CUPSADMIN, CUPSPASSWORD, AVAHI_HOSTNAME, TZ

services: cups: image: chuckcharlie/cups-avahi-airprint:latest container_name: cups network_mode: host volumes: - ./config:/config environment: CUPSADMIN: "" CUPSPASSWORD: "" # TZ: "Europe/Vienna" # optional, defaults to UTC # AVAHI_HOSTNAME: "cups-airprint" # optional, change if it conflicts on your network restart: unless-stopped

Must run on host network for multicast AirPrint discovery. Exposes port 631 to LAN.

cups-avahi-airprint releases & version history

More in Device Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…