Skip to content
View in the app

A better way to browse. Learn more.

Unraid

A full-screen app on your home screen with push notifications, badges and more.

To install this app on iOS and iPadOS
  1. Tap the Share icon in Safari
  2. Scroll the menu and tap Add to Home Screen.
  3. Tap Add in the top-right corner.
To install this app on Android
  1. Tap the 3-dot menu (⋮) in the top-right corner of the browser.
  2. Tap Add to Home screen or Install app.
  3. Confirm by tapping Install.

[SUPPORT] cups DOCKER REPOSITORY

Featured Replies

On 11/5/2022 at 3:23 PM, Copycat300 said:

I updated my Unraid server to 6.11.2 today.

 

When I attempted to start the CUPS docker, I get an Execution Error dialog box.  It states "Execution Error" and "Server error" in a single dialog box, and refuses to start.  

 

Anyone else observed this?  

I just updated to Unraid 6.11.3 today and I get exactly the same problem and error message.  Did you figure out how to fix it?

  • 2 weeks later...
  • Replies 67
  • Views 27.8k
  • Created
  • Last Reply

Top Posters In This Topic

Most Popular Posts

  • Rick_Sanchez,   cups Docker container -> Edit -> Change from 'Basic View' to 'Advanced View' (upper right toggle) Under "Extra Parameters" append this to the end:  --device=$(read

  • Thnx a lot for this container. i am search a long time for this. all i try before dont worked very well under unraid then i used a vm for cups. 1st tests are very very well.

  • Please check 2 posts above and you'll see my post on how to make it work. See if my instructions work for you! Happy to take feedback, too.

Posted Images

Thanks, I set this up on my HP p1102W printer. Works great!

  • 1 month later...
On 5/7/2022 at 10:38 PM, Devnol said:

then the /boot/config/go code for the above is as such:

cp /boot/config/rules.d/99-usb-rules.rules /etc/udev/rules.d/99-usb-rules.rules
cp /boot/config/cups/printer.sh /usr/local/bin/printer.sh

chmod 644 /etc/udev/rules.d/99-usb-rules.rules
chmod 744 /usr/local/bin/printer.sh

udevadm control --reload-rules

udevadm trigger --attr-match=subsystem=usb


sehe ich das richtig, das udevadm nach einem 'trigger' warten kann?
also wie hier z.B. das usb?

 

wäre es dann möglich den Drucker zu 'triggern' (also wenn USB angesteckt wird und der Drucker erkannt wird)

udevadm trigger --sysname-match=Druckername(z.B.Samsung CLP510)

 

und dann udevadm control --reload-rules
(hier sollten ja dann die Regeln neu geladen werden, oder?

hier sollte doch dann die /boot/config/rules.d
(Inhalt: SUBSYSTEM=="tty", ENV{ID_SERIAL_SHORT}=="3721BAAYC07316Y.", SYMLINK+="USBPRINT")
neu geladen werden oder?

falls das möglich ist, wie muss / sollte das dann umgesetzt werden.

würde mich über hilfe sehr freuen.

 

 

-----------------------------------------------------------

 

Am I correct in saying that udevadm can wait after a 'trigger'?
like here e.g. the usb?

would it then be possible to 'trigger' the printer (i.e. when USB is plugged in and the printer is recognized)

udevadm trigger --sysname-match=printer name(e.g. Samsung CLP510)

and then udevadm control --reload-rules
(the rules should be reloaded here, right?

here the /boot/config/rules.d
(Contents: SUBSYSTEM=="tty", ENV{ID_SERIAL_SHORT}=="3721BAAYC07316Y.", SYMLINK+="USBPRINT")
be reloaded right?

if this is possible, how must / should it be implemented.

Would appreciate help very much.

 

Edited by luckyheiko

  • 4 weeks later...

Updated the CUPS docker quite some time ago, seems to have broken something. When I first installed (over a year ago) It would print fine to my Zebra thermal printer. Just getting around to trying to fix it now.

 

Now, CUPS will only spit out blank labels (printer works when not using CUPS).

 

I'm at a loss.

  • 3 weeks later...
On 11/21/2022 at 12:05 AM, P.Mass said:

I just updated to Unraid 6.11.3 today and I get exactly the same problem and error message.  Did you figure out how to fix it?

The issue is due to your USB port changing for your printer. This will happen every time you restart your Unraid server. There is a way to get it to reconnect automatically but the instructions I found on another thread didn't work for me as the command didn't find the file needed for my device. I considered another airprint application but don't have time to switch right now. 

  • 4 weeks later...

Hey all,

I'm lookin for some help with this cups docker. I'm in the middle of setting up VLANs for my network and wanted my printer and scanners to be within their own but for the life of me I cannot get cups to work with all the other subnets. I've upgraded to a Dream Machine and all the traffic is currently flowing unrestricted to each VLAN since I'm still testing it all out during setup.

 

I've edited the cupsd.conf so many times based on findings from the internet but I cannot get the printers to show up on other subnets. Crazy thing is, my iPhone can see a printer but my pcs do not discover it. When selecting it on the phone I get an error. If the docker gets switched to bridge network mode they come right up and work.

 

Would love any ideas!

I wasn't able to successfuly get the "Or Provide a PPD File" option to work. Has anyone uploaded their own PPD file? If so, how did you get it work?

Hi. Is it possibel to install cups-pdf?

I try to install a pdf printer, printing a business layout watermark, available for everyone in the network....

regards Oliver

  • 3 weeks later...

Would anyone be willing to help troubleshoot how to get this on a vlan? I have not had success isolating this into my iot vlan group. It’s the only docker that refuses to function correctly. 
 

Is something hard coded to only function in bridge mode or local host?

  • 1 month later...

Why does this work with /dev/bus/usb/001/005 (where my printer resides) but not with /dev/usb/lp0?

 

Edit: Oh okay I figured it out, since the contaienr itself creates a lp0 internally, it needs raw device. Got it

Edited by Arandomdood

  • 7 months later...

Hi, Thanks for your great work.

Is it possible to update hplip for this docker container? My printer do not have a driver for my HP OfficeJet 8010.

Thank you. 

  • 7 months later...

Hiya, I have Brother HL 1112 printer, I found PPD driver and managed to install the printer in the docker, but it gives me an error about missing file:

 

Idle - "File "/usr/lib/cups/filter/brother_lpdwrapper_HL1110" not available: No such file or directory"

 

I have no idea how to sort it out, any chance you could add this driver to the package or explain how to add this file to the docker

  • 6 months later...

Hi,

I installed the Cups Docker and installed a usb printer.

The Printer didn‘t work. I have this fault message:

 

Leerlauf - "File "/usr/lib/cups/filter/Nelko/Filter/rastertolabel" not available: No such file or directory"
 

It‘s a Nelko Pl70-bt Label Printer.

  • 5 months later...
On 12/4/2022 at 3:44 PM, bonzi said:

Thanks, I set this up on my HP p1102W printer. Works great!

This now seems to be broken unfortunately. I cannot connect to the printer from another computer or even print a test page directly from CUPS. Not sure how to troubleshoot it, on Unraid 7.1.2. Let me know if there are useful details that can be provided to figure out why it is not working.

  • 3 weeks later...

Hello, is it possible to run this docker as something else then root?

  • 1 month later...

For those with usb id problems willing to set the priviliged flag and "just want it to work" after reboots:

  • remove the device mount

  • add a folder mount of /dev/bus/usb to /dev/bus/usb

  • set the priviliged flag

The flag has a bit of an aftertaste, but it will find the printer again

Better defined via udev rules symlink is great, but I don't have the time right now + smth ui configureable would be nice for those without the skills

  • 6 months later...

Fix for the USB device path changing all the time. No privileged flag needed, here are the directions in case anyone needs it:

The Problem

CUPS maps to a specific USB device path like /dev/bus/usb/003/023 which changes on every reboot, causing the printer to disappear.

The Solution

Create a persistent udev symlink for the printer, then map both the symlink and the USB bus into the container.


Step 1 — Find Your Printer's USB IDs

In the Unraid terminal run:

bash

lsusb

Look for your printer in the output, e.g.:

Bus 003 Device 023: ID 03f0:052a HP, Inc LaserJet M1212nf MFP

Note the two values after ID03f0 is the vendor ID, 052a is the product ID.


Step 2 — Create the udev Rule

bash

nano /etc/udev/rules.d/99-usb-printer.rules

Paste this (substituting your own vendor/product IDs):

SUBSYSTEM=="usb", ATTRS{idVendor}=="03f0", ATTRS{idProduct}=="052a", SYMLINK+="usb_printer", MODE="0666"
  • Ctrl+O → save

  • Enter → confirm

  • Ctrl+X → exit


Step 3 — Reload udev and Trigger It

bash

udevadm control --reload-rules && udevadm trigger

Verify the symlink was created:

bash

ls -la /dev/usb_printer

You should see something like:

lrwxrwxrwx 1 root root ... /dev/usb_printer -> bus/usb/003/023

Step 4 — Update CUPS Container in Unraid

In the Unraid Docker tab, click Edit on your CUPS container. Remove any existing USB device mapping (the one pointing to a specific /dev/bus/usb/00x/00x path), then add these two entries:

Entry 1 — Device mapping:

Field

Value

Config Type

Device

Name

USB Printer

Value

/dev/usb_printer

Entry 2 — Path mapping:

Field

Value

Config Type

Path

Name

USB Bus

Container Path

/dev/bus/usb

Host Path

/dev/bus/usb

Access Mode

Read/Write

Default Value

(leave blank)

Click Apply and let the container restart.


Step 5 — Verify

Open the CUPS web UI at http://[unraid-ip]:631, go to Printers → your printer → dropdown → Print Test Page. The job should process and print successfully.

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

Account

Navigation

Search

Search

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.