Replace nonexistent linuxserver/cups with custom Dockerfile

Builds from debian:bookworm-slim with cups, cups-filters, ghostscript,
imagemagick, foomatic, gutenprint, hplip, dymo, splix, and more.
Removes PUID/PGID env vars (not applicable to a plain Debian image).

Made-with: Cursor

Author: romkey

apps/cups/.env.example

@@ -1,8 +1,2 @@
-# UID/GID the CUPS process runs as inside the container.
-# Match the host user that owns ../../lib/cups if you care about file permissions.
-PUID=1000
-PGID=1000
-
-TZ=America/Los_Angeles
-
+# Image tag to use when building/pulling (default: latest)
 #IMAGE_VERSION=latest

apps/cups/Dockerfile

@@ -0,0 +1,51 @@
+FROM debian:bookworm-slim
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    # Core print server
+    cups \
+    cups-client \
+    # Filter pipeline: PDF, PostScript, raster, text
+    cups-filters \
+    cups-browsed \
+    # PostScript / PDF rendering
+    ghostscript \
+    # PDF utilities
+    poppler-utils \
+    qpdf \
+    # Image conversion (TIFF, PNG, JPEG, BMP, …)
+    imagemagick \
+    # CUPS raster image library
+    libcupsimage2t64 \
+    # Generic printer driver database + filter
+    foomatic-db \
+    foomatic-db-engine \
+    foomatic-db-compressed-ppds \
+    # High-quality open-source raster drivers (Epson, Canon, etc.)
+    printer-driver-gutenprint \
+    # HP printers
+    hplip \
+    # Brother / generic PCL
+    printer-driver-foo2zjs \
+    # Dymo label printers
+    printer-driver-dymo \
+    # PostScript-capable printers (pxljr, etc.)
+    printer-driver-pxljr \
+    # m2300w / m3300mfp
+    printer-driver-m2300w \
+    # SpliX (Samsung/Xerox SPL-II raster)
+    printer-driver-splix \
+    # Healthcheck / debug
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Directories CUPS expects at runtime
+RUN mkdir -p \
+    /var/spool/cups/tmp \
+    /var/log/cups \
+    /run/cups \
+    /usr/share/cups/model/custom
+
+# Run CUPS in the foreground (-f) so Docker captures stdout/stderr
+EXPOSE 631
+
+CMD ["/usr/sbin/cupsd", "-f"]

apps/cups/README.md

@@ -1,21 +1,24 @@
 # cups
 
-Containerised CUPS print server using the
-[LinuxServer CUPS image](https://docs.linuxserver.io/images/docker-cups/),
-which ships with a comprehensive set of print filters and supporting programs:
+Containerised CUPS print server built from a Debian Bookworm base with a
+comprehensive set of print filters and drivers installed:
 
 | Package | Purpose |
 |---|---|
-| `cups` | Core print server and IPP listener |
-| `cups-filters` | PDF, PostScript, raster, and text filter chain |
+| `cups` + `cups-client` | Core print server and IPP listener |
+| `cups-filters` + `cups-browsed` | PDF, PostScript, raster, and text filter chain |
 | `ghostscript` | PS/PDF rendering |
 | `poppler-utils` | PDF inspection and conversion |
 | `qpdf` | PDF linearisation and repair |
 | `imagemagick` | Image format conversion (PNG, JPEG, TIFF, …) |
-| `foomatic-db` + `foomatic-db-engine` | Generic printer driver database |
-| `printer-driver-gutenprint` | High-quality open-source raster drivers |
-| `hplip` | HP printer drivers |
 | `libcupsimage2t64` | CUPS raster image library |
+| `foomatic-db` + `foomatic-db-engine` + `foomatic-db-compressed-ppds` | Generic printer driver database |
+| `printer-driver-gutenprint` | High-quality open-source raster drivers (Epson, Canon, etc.) |
+| `hplip` | HP printer drivers |
+| `printer-driver-foo2zjs` | Brother / generic PCL drivers |
+| `printer-driver-dymo` | Dymo label printers |
+| `printer-driver-splix` | Samsung / Xerox SPL-II raster |
+| `printer-driver-pxljr` | PostScript-capable PCL drivers |
 
 ## Networks
 
@@ -48,13 +51,10 @@ cp /path/to/Printer80.ppd apps/cups/ppds/
 ## First-time setup
 
 ```sh
-cp .env.example .env
-# Edit .env if you need non-default PUID/PGID or TZ
-
 cp config/cupsd.conf.default config/cupsd.conf
 # Edit config/cupsd.conf if you need to restrict or expand access
 
-docker compose up -d
+docker compose up -d --build
 ```
 
 The CUPS web UI is available at `http://cups:631` from other containers on

apps/cups/docker-compose.yml

@@ -1,13 +1,10 @@
 services:
   cups:
-    image: lscr.io/linuxserver/cups:${IMAGE_VERSION:-latest}
+    build: .
+    image: cups:${IMAGE_VERSION:-latest}
     container_name: cups
     hostname: cups
     restart: unless-stopped
-    environment:
-      PUID: ${PUID:-1000}
-      PGID: ${PGID:-1000}
-      TZ: ${TZ:-America/Los_Angeles}
     volumes:
       - ../../lib/cups:/config
       - ./config/cupsd.conf:/etc/cups/cupsd.conf:ro