print-blockage-stopper

Overview

Automated maintenance prints for any network printer (especially pigment printers like Canon imagePROGRAF, Epson SureColor, HP DesignJet, etc.). Sends a small test image on a configurable schedule (default: every 3 days) to keep all ink channels flowing and prevent costly pigment clogs and cleaning cycles. Features: multi-printer support, network printer discovery, per-printer schedules, smart skip (won't print if the printer was recently used), preset test images for 4/6/8/11/12-colour printers, custom image upload, notifications (webhook, email, Home Assistant), and a modern React dashboard with dark mode.

Requirements

Any network printer with IPP Everywhere support (usually any modern networked printer). Especially useful for pigment printers.

Runtime arguments

Web UI: http://[IP]:[PORT:8631]
Network: bridge
Privileged: false
Extra Params: --cap-drop=ALL --cap-add=DAC_OVERRIDE --cap-add=CHOWN --cap-add=FOWNER --cap-add=SETUID --cap-add=SETGID --security-opt=no-new-privileges

Template configuration

DashboardPorttcp

Web dashboard for managing printers, schedules, and test images.

Target: 8631
Default: 8631
Value: 8631

CUPS Web UIPorttcp

CUPS print server interface for advanced monitoring.

Target: 631
Default: 631
Value: 631

Printer IP AddressVariable

(Optional) IP address of a printer to auto-add on first boot. You can also add printers from the dashboard after starting the container.

Target: PRINTER_IP

Default Print ScheduleVariable

Default cron expression for new printers. Can be customised per-printer in the dashboard. Default: every 3 days at 10 AM.

Target: SCHEDULE
Default: 0 10 */3 * *
Value: 0 10 */3 * *

Default Paper SizeVariable

Default paper size for new printers (e.g., A4, Letter, A3). Can be changed per-printer.

Target: PAPER_SIZE
Default: A4
Value: A4

Default Skip HoursVariable

Default hours to skip maintenance print if printer was recently used. Adjustable per-printer in the dashboard.

Target: SKIP_HOURS
Default: 72
Value: 72

Connection TypeVariable

Default connection type for new printers: 'ipp' (recommended) or 'socket' (port 9100).

Target: CONNECTION
Default: ipp
Value: ipp

Webhook URLVariable

(Optional) URL for print success/failure notifications. Works with Slack incoming webhooks, Discord webhooks, ntfy.sh, or any endpoint accepting JSON POST.

Target: WEBHOOK_URL

Printer PortVariable

Default port for socket connections (only used when Connection Type is 'socket').

Target: PRINTER_PORT
Default: 9100
Value: 9100

Data / LogsPath

Persistent storage for printer config, logs, uploads, and CUPS state.

Target: /data
Default: /mnt/user/appdata/print-blockage-stopper
Value: /mnt/user/appdata/print-blockage-stopper

Unraid NotificationsPath

Mount Unraid's notification script to get alerts on print failures. Leave default for standard Unraid installs.

Target: /unraid/notify
Default: /usr/local/emhttp/webGui/scripts/notify
Value: /usr/local/emhttp/webGui/scripts/notify

Links

Template Support Docker Hub Project

Details

Repository

abadrdh/print-blockage-stopper

Registry

https://hub.docker.com/r/abadrdh/print-blockage-stopper

Last Updated2026-04-05

First Seen2026-03-29

Run print-blockage-stopper on Unraid.

print-blockage-stopper is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS