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
- In the Admin Portal, go to DEVICE MANAGEMENT > Software Management > Windows.
- Click +.
- Select Custom App. A New Custom App panel opens.
To learn about Windows Software Management with Chocolatey Apps, see Manage Software for Windows with Chocolatey.
- Under Application Details, enter the Application Name.
- (Optional) Under Deployment Configurations, enter any desired installer flags, such as /quiet or others.
- 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.
- Click Upload. An upload progress bar appears and you will see a File uploaded successfully message.
- 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.
- This processing is relatively quick, but we can’t instantiate any changes (such as device bindings) while the message is displayed.
- Either refresh the page or navigate away and return to this page to proceed.
- 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.
- In the Admin Portal, go to DEVICE MANAGEMENT > Software Management > Apple.
- Click + to add a new managed software app.
- Select Custom App. A New Custom App panel opens.
To learn about Apple Software Management with Self-Hosted Apps, see Software Management: macOS and iOS.
- Under Application Details, enter the Application Name.
- 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.
- Click Upload. An upload progress bar appears and you will see a File uploaded successfully message.
- 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.
- This processing is relatively quick, but we can’t instantiate any changes (such as device bindings) while the message is displayed.
- Either refresh the page or navigate away and return to this page to proceed.
- 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
Failed validation is only displayed by clicking on the application instance from the Software Management list.
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
If you are adding a new managed software application, you have the option to bind and install the application directly after uploading it.
- In the Admin Portal, go to DEVICE MANAGEMENT > Software Management.
- Choose the appropriate OS tab and find the application you want to bind or unbind.
- Click to open the managed application details.
- From the Devices tab, select the devices where you want to install the software.
- 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.
If the device group has dynamic membership controls, be aware that devices will be added and/or removed in the future based on the rule-based attributes of the group. See Configure Dynamic Device Groups for more information. Further, it is not possible to remove individual bound device(s) from a dynamic group within Software Management, as the device will be re-enrolled into the dynamic device group if it still meets the rule-based attributes associated with the group. You will need to unbind the device from the dynamic group under Device Groups first.
- 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.
- Click Save & Install to proceed with the software installation. A success message indicates whether the installation was successful.
Viewing the Status of Managed Software
- 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.
- Install failed: Installation failed on the device. Action is required.
- Click View to see installation results specific to the individual device, including versioning information for the application.
Deleting Managed Software Configurations
Deleting a managed software instance from devices and/or device groups does not uninstall the application from those devices.
To delete a managed software:
- In the Admin Portal, go to DEVICE MANAGEMENT > Software Management.
- Choose the appropriate OS tab and select the application you want to delete.
- 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.
- For managed Apple software packages, enter the number of applications you are attempting to delete and click delete.
- The application is no longer managed by JumpCloud. Note this does not uninstall the application from any bound devices.