Custom Printers

Install printers on macOS devices with a Custom Printer Library item in Kandji.

Getting Started

Before you create your Custom Printer Library item, you will need two files. The driver installer package associated with that printer and the file path to the PPD installed by the package. Typically the correct PPD can be identified by the model name appearing in the filename.

After you have collected these two files you will then need to gather the following information.

  • The display name of the printer (eg. Marketing Printer)

  • The CUPS name of the printer (eg. marketing_printer)

  • The location description (eg. 2nd Floor)
  • The printer URI (eg. lpd:// or ipp://hostname.local/queue_name)

Creating a Custom Printer library item

Add a Custom Printer item:

  1. Click Library in the left-hand navigation bar.
  2. Click Add New in the upper right-hand corner.
  3. Click Custom Printer from the Add New window.

Configure the Custom Printer item:

  1. Give your Custom Printer a Name.
  2. Assign your Custom Printer to a test Blueprint.
  3. Set the Execution Frequency.
  4. Enter the description that the user will see on their computer.
  5. Enter the CUPS printer name. You should remove any special characters and replace spaces with underscore characters. Dashes are not allowed in CUPS queue names. 
  6. Enter the printer location. This will be visible to the user in the location field of their printer preferences.
  7. Enter the device URI. The URI is usually the print protocol (ipp:// or lpd:// or dnssd://) followed by the hostname or ip address of the printer. If you are sending the print jobs to a print server, you will typically see the queue name appended after the hostname (eg. lpd://print-server.local/queue_name).
  8. Specify the path to the PPD, use the Apple-provided generic driver, or AirPrint.
  9. Enter the full file path for the PPD.
  10. Select the option to install the printer software package.
  11. Drag the printer installer package into the upload box.


Save your custom printer and then test on a device assigned to your test blueprint.