hp41/papercut-cups-provider repository overview

⁠hp41/papercut-cups - CUPS Print Provider for Papercut

⁠Papercut MF⁠

PLEASE AGREE TO PAPERCUT'S TOS BEFORE CONTINUING⁠

⁠Docker Image features

• Has CUPS installed.
• papercut account setup. Home dir=/papercut.
• A CUPS admin account is setup (in entrypoint) - Default=cups_admin.
• Papercut CUPS print provider setup under /papercut.
• /etc/init.d/cups is started in the background.
• /papercut/providers/print/linux-x64/pc-event-monitor started in console therefore it outputs to stdout.
• Includes Ansible role cups⁠.

⁠Ansible role cups⁠ details

• Just runs the remove/purge/install printers and classes tasks.
  • This is useful for managing printer(s).
  • This is setup in /install-printers directory within the container.
  • For the role to manage printers and classes, their definitions can be placed in these files:
    • Inside container: /install-printers/group_vars/printer_list.yml
      • Ensure to place the list of printer definitions under the variable: printer_list.
    • Inside container: /install-printers/group_vars/class_list.yml
      • Ensure to place the list of printer definitions under the variable: class_list.
  • Have look at how the printer and class definitions can be listed here:
    • The cups_lpadmin module that does the heavy lifting⁠
    • Example printer_list.yml⁠
    • Example class_list.yml⁠

⁠Folders/files inside the container that can be of interest

• /papercut/providers/print/linux-x64/print-provider.conf⁠
• /etc/cups/⁠
  • cupsd.conf
  • cups-browsed.conf
  • cups-files.conf
  • printers.conf
  • snmp.conf
  • cups-pdf.conf
• /opt/share/ppd⁠ - Custom PPDs can be placed here.
• /install-printers/group_vars⁠
  • printer_list.yml
  • class_list.yml

⁠docker run example

docker run -d \
    -p 631:631 \
    -e "CUPS_ADMIN_PWD=test12345" \
    -e "ANSIBLE_MANAGE_PRINTERS=true" \
    -v /path/on/host/to/print-provider.conf:/papercut/providers/print/linux-x64/print-provider.conf \
    -v /path/on/host/to/cupsd.conf:/etc/cups/cupsd.conf \
    -v /path/on/host/to/printer_list.yml:/install-printers/group_vars/printer_list.yml \
    -v /path/on/host/to/class_list.yml:/install-printers/group_vars/class_list.yml \
    hp41/papercut-cups-provider