print-blockage-stopper

print-blockage-stopper

Application Docker from abadr's Repository

Vue d'ensemble

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.

Exigences

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

Arguments d'exécution

Interface utilisateur Web
http://[IP]:[PORT:8631]
Réseau
bridge
Privilégié
false
Paramètres supplémentaires
--cap-drop=ALL --cap-add=DAC_OVERRIDE --cap-add=CHOWN --cap-add=FOWNER --cap-add=SETUID --cap-add=SETGID --security-opt=no-new-privileges

Configuration du modèle

DashboardPorttcp

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

Cible
8631
Défaut
8631
Valeur
8631
CUPS Web UIPorttcp

CUPS print server interface for advanced monitoring.

Cible
631
Défaut
631
Valeur
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.

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

Cible
SCHEDULE
Défaut
0 10 */3 * *
Valeur
0 10 */3 * *
Default Paper SizeVariable

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

Cible
PAPER_SIZE
Défaut
A4
Valeur
A4
Default Skip HoursVariable

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

Cible
SKIP_HOURS
Défaut
72
Valeur
72
Connection TypeVariable

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

Cible
CONNECTION
Défaut
ipp
Valeur
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.

Cible
WEBHOOK_URL
Printer PortVariable

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

Cible
PRINTER_PORT
Défaut
9100
Valeur
9100
Data / LogsPath

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

Cible
/data
Défaut
/mnt/user/appdata/print-blockage-stopper
Valeur
/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.

Cible
/unraid/notify
Défaut
/usr/local/emhttp/webGui/scripts/notify
Valeur
/usr/local/emhttp/webGui/scripts/notify

Télécharger les statistiques

991
Total des téléchargements

Détails

Référentiel
abadrdh/print-blockage-stopper
Dernière mise à jour2026-04-05
Première vue2026-03-29

Exécutez print-blockage-stopper sur Unraid.

print-blockage-stopper est listé dans Community Apps pour Unraid OS. Explorez Unraid pour créer un serveur domestique flexible, un NAS ou un laboratoire domestique.