Deploy PaperCut Hive and Pocket using Microsoft Intune (macOS)

You need to download the PaperCut Pocket or PaperCut Hive client software files from the Jamf Pro Add-on.

1. In the PaperCut Hive or Pocket admin console, in the left menu, select Add-ons.

2. On the Device management tab, locate the Jamf Pro card and click Learn More.
   

3. Click Add.
   The Review authorizations popup is displayed.
   

4. Read the points, select the I agree that: checkbox and select Agree to enable this add-on for your organization

5. Click the Setup instructions tab.
   

6. Click the Download zip file button to download the PaperCut Hive or Pocket client software zip file to your computer.

7. Upload the papercut-hive.zip or papercut-pocket.zip file to your preferred cloud storage. Take a copy of the download URL. Note, this URL should provide a direct download of the installer zip.

8. Close the Jamf Pro add-on instructions window.

9. In the PaperCut Hive admin console, go to Manage > Edge Mesh and click Add edge nodes.

   

10. Select Manually deploy edge nodes.

11. Under Step 2, click the Copy button to copy the command line and paste it into a text editor. You'll need the /systemkey value later.
    

To deploy the PaperCut Hive or Pocket client software to managed-macOS devices requires you use a shell script. https://learn.microsoft.com/en-us/mem/intune/apps/macos-shell-scripts

1. Copy the below script relevant to your product, and save this as a .sh file on your computer.

   PaperCut Hive

   #!/usr/bin/env zsh
   
   # Download the PaperCut Hive installer zip file from your chosen cloud storage location.
   cd /var/tmp
   curl "https://your-cloud-storage-location/temp/papercut-hive.zip" -O -J -L
   unzip papercut-hive.zip
   
   # Create a variable specifying the unzip location (default: var/tmp)
   HIVE_INSTALLER_PATH="/var/tmp/hive_installer"
   
   # Get the current logged in user excluding loginwindow, _mbsetupuser, and root
   current_user=$(/usr/sbin/scutil <<<"show State:/Users/ConsoleUser" |
   /usr/bin/awk '/Name :/ && ! /loginwindow/ && ! /root/ && ! /_mbsetupuser/ { print $3 }' |
   /usr/bin/awk -F '@' '{print $1}')
   
   # Make sure that we can find the most recent logged-in user
   if [[ $current_user == "" ]]; then
   # Because someone other than the current user was returned, we are going to look at
   # who uses this Mac the most, then set the current user to that user.
   current_user=$(/usr/sbin/ac -p | /usr/bin/sort -nk 2 |
   /usr/bin/grep -E -v "total|admin|root|mbsetup|adobe" | /usr/bin/tail -1 |
   /usr/bin/xargs | /usr/bin/cut -d " " -f1)
   fi
   
   # Install the PaperCut Hive software with system administrator privileges
   # This code is private to your PaperCut organisation. Please do not share it
   # Replace 'yy' with the regional data centre region code e.g. au,us,eu,uk
   # Replace 'zz' with the OrgID
   cd ${HIVE_INSTALLER_PATH}
   ./install.sh xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx yy zz
   
   # Install the PaperCut client as the current user
   /usr/sbin/chown -R $current_user ${HIVE_INSTALLER_PATH}
   /usr/bin/su - "$current_user" -c "cd ${HIVE_INSTALLER_PATH} && ./install.sh install_client"
   
   # Remote installation files
   rm -d -r /var/tmp/hive_installer
   sudo rm /var/tmp/papercut-hive.zip
   

   PaperCut Pocket

   #!/usr/bin/env zsh
   
   # Download the PaperCut Pocket installer zip file from your chosen cloud storage location.
   cd /var/tmp
   curl "https://your-cloud-storage-location/temp/papercut-pocket.zip" -O -J -L
   unzip papercut-pocket.zip
   
   # Create a variable specifying the unzip location (default: var/tmp)
   POCKET_INSTALLER_PATH="/var/tmp/pocket_installer"
   
   # Get the current logged in user excluding loginwindow, _mbsetupuser, and root
   current_user=$(/usr/sbin/scutil <<<"show State:/Users/ConsoleUser" |
   /usr/bin/awk '/Name :/ && ! /loginwindow/ && ! /root/ && ! /_mbsetupuser/ { print $3 }' |
   /usr/bin/awk -F '@' '{print $1}')
   
   # Make sure that we can find the most recent logged-in user
   if [[ $current_user == "" ]]; then
   # Because someone other than the current user was returned, we are going to look at
   # who uses this Mac the most, then set the current user to that user.
   current_user=$(/usr/sbin/ac -p | /usr/bin/sort -nk 2 |
   /usr/bin/grep -E -v "total|admin|root|mbsetup|adobe" | /usr/bin/tail -1 |
   /usr/bin/xargs | /usr/bin/cut -d " " -f1)
   fi
   
   # Install the PaperCut Pocket software with system administrator privileges
   # This code is private to your PaperCut organisation. Please do not share it
   # Replace 'yy' with the regional data centre region code e.g. au,us,eu,uk
   # Replace 'zz' with the OrgID
   cd ${POCKET_INSTALLER_PATH}
   ./install.sh xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx yy zz
   
   # Install the PaperCut client as the current user
   /usr/sbin/chown -R $current_user ${POCKET_INSTALLER_PATH}
   /usr/bin/su - "$current_user" -c "cd ${POCKET_INSTALLER_PATH} && ./install.sh install_client"
   
   # Remote installation files
   rm -d -r /var/tmp/pocket_installer
   sudo rm /var/tmp/papercut-pocket.zip
   

2. Update the script with the identity of your PaperCut Hive or Pocket tenancy.

   1. Update the download URL, https://your-cloud-storage-location/temp/papercut-hive.zip or https://your-cloud-storage-location/temp/papercut-pocket.zip, to point to your cloud storage location.

   2. Replace xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx with the value of your organization's /systemkey you noted down earlier.

   3. Replace yy with the regional hosting location of your tenancy. For example, au, us, uk, eu.

3. Sign in to your Intune admin interface, for example, https://intune.microsoft.com.

4. In the left menu, select Devices.

5. In the sub-menu, select macOS.

6. From the left-hand menu, select Shell scripts

7. Select Add.

8. Enter a name for your script. For example, PaperCut Hive Client Software Deployment.

9. Upload the .sh script we created in step 1.

10. Set Run script as signed-in user to No.

11. Set Hide script notifications on devices to Yes.

12. Leave Script frequency as Not configured.

13. Set Max number of times to retry if script fails to 1 time.

14. Under the Assignments section, apply your selection of groups or users for which this script should apply.

15. Review your configuration and save the script.

Alongside the logging available in the Intune admin interface, which shows the script's successful execution, manually check three areas on a sample workstation.

1. In the PaperCut Hive or Pocket admin console, confirm that the device is listed in the Edge Mesh tab and is showing as online.

2. Open System Settings > Printers & Scanners (for macOS 13 Ventura or newer) or System Preferences > Printers & Scanners (for macOS 12 Monterey or earlier). Confirm that the PaperCut Printer is displayed.

3. Open the PaperCut Hive or Pocket invite email for the user and click the link in that email. This causes the PaperCut Hive or Pocket print client on that macOS device to be linked to that user.

4. Send a test print job and validate it in your PaperCut Hive or Pocket admin console. Go to the Job Log, find the job, and see if it's linked to the correct user.