Manage Software with JumpCloud Private Repository

With JumpCloud's Software Management Private Repository, you can upload and install Windows and Apple software application files through an intuitive and frictionless interface. With this feature, you don't have to host custom applications yourself or depend on third-party solutions.

 Some benefits of the JumpCloud Private Repo include:

• Ability to control the files you deploy to your endpoints
• No need to set up and maintain your own hosting solution
• Control of which application gets installed where, without having to rely on public application repositories

Considerations:

• Supports MSI (Windows) and PKG (Apple) file formats.
• Storage is limited to 10GB for Early Access customers.
• Maximum application size is 5GB

Prerequisites:

• Requires Windows MDM for MSI deployments
• Requires Apple MDM for PKG deployments
• Packages must include valid, signed certifications

Uploading and Validating Application Files

Windows Custom Application

These steps walk you through uploading and validating the application file for Windows devices. You can also configure Windows applications with command line options before installing them

1. In the Admin Portal, go to DEVICE MANAGEMENT > Software Management > Windows.
2. Click +.
3. Select Custom App. A New Custom App panel opens.
   

4. Under Application Details, enter the Application Name.
5. (Optional) Under Deployment Configurations, enter any desired installer flags, such as /quiet or others.
6. Under Upload File, drag and drop a file to the upload area or click Choose a File to browse for a file. Only MSI file types are supported for Windows devices.
7. Click Upload. An upload progress bar appears and you will see a File uploaded successfully message.
8. As the file is being processed, you will see a message: Your application is still being processed by JumpCloud. You cannot associate devices to a custom application while it is processing. When the application is done processing, either refresh or close and reopen this configuration page to make device associations.
   • This processing is relatively quick, but we can’t instantiate any changes (such as device bindings) while the message is displayed.
     
9. Either refresh the page or navigate away and return to this page to proceed.
10. You can now bind and install the application on specific devices or device groups. See Binding and Installing Applications on Devices or Device Groups.

Apple Custom Application

These steps walk you through uploading and validating the application file on Apple devices.

1. In the Admin Portal, go to DEVICE MANAGEMENT > Software Management > Apple.
2. Click + to add a new managed software app.
3. Select Custom App. A New Custom App panel opens.
   

4. Under Application Details, enter the Application Name.
5. Under Upload File, drag and drop a file to the upload area or click Choose a File to browse for a file. Only PKG file types are supported for Apple devices.
6. Click Upload. An upload progress bar appears and you will see a File uploaded successfully message.
7. As the file is being processed, you will see a message: Your application is still being processed by JumpCloud. You cannot associate devices to a custom application while it is processing. When the application is done processing, either refresh or close and reopen this configuration page to make device associations.
   • This processing is relatively quick, but we can’t instantiate any changes (such as device bindings) while the message is displayed.
     
8. Either refresh the page or navigate away and return to this page to proceed.
9. You can now bind and install the application on specific devices or device groups. See Binding and Installing Applications on Devices or Device Groups.

Resolving Upload or Validation Failures

Upload Failures

When a software upload fails, a message appears on the Details tab: The file upload failed. Please delete this instance and try again. To proceed, click Delete to remove the application instance and follow the upload process again.

Validation Failures

When a package upload can't be validated, a message appears in the Details tab of the newly created application. To proceed, click Delete to remove the application instance and start the upload process again.

Binding and Installing Applications on Devices or Device Groups

1. In the Admin Portal, go to DEVICE MANAGEMENT > Software Management. 
2. Choose the appropriate OS tab and find the application you want to bind or unbind.
   
3. Click to open the managed application details.
4. From the Devices tab, select the devices where you want to install the software.
   
5. Click the Device Groups tab and select the device groups where you want to bind the application. The application will be installed on all devices within the group with an eligible OS for that application type.
   
   • To unbind device groups, select Show bound device groups to see the groups where the application is currently bound, then clear the selection next to groups you want to unbind. Unbinding software from a device group will remove bindings for all devices within the group.
   • Note: There is a known bug that we aim to resolve by GA of this feature where bulk unbinding of group-assigned devices from the Devices tab results in a failed unbind. To unbind group-bound devices, please use the Device Groups tab to unbind the group, or remove individual devices from the device group first.

6. When you are finished selecting the devices and device groups where you want the application to be installed, click Save & Install. A Managed Software Associations confirmation appears.
   
7. Click Save & Install to proceed with the software installation. A success message indicates whether the installation was successful.

Viewing the Status of Managed Software

1. From the managed application details screen, click the Status tab to see the status of the application, including all devices where the application is bound, and the installation status.
   
   • Install failed: Installation failed on the device. Action is required.
     • Click Retry to initiate a retry installation on a single device.
   • Install Success: Installation succeeded and the application is now managed by JumpCloud on the device. No action is required.
   • Install Pending: Installation is in progress on the device. No action is currently required.
2. Click View to see installation results specific to the individual device, including versioning information for the application.
   
   

Deleting Managed Software Configurations

To delete a managed software:

1. In the Admin Portal, go to DEVICE MANAGEMENT > Software Management. 
2. Choose the appropriate OS tab and select the application you want to delete.
3. Click delete. A confirmation modal appears.
   • For managed Apple software packages, enter the number of applications you are attempting to delete and click delete.
     
   • For managed Windows software packages, click delete.
     
4. The application is no longer managed by JumpCloud. Note this does not uninstall the application from any bound devices.