Self Service: Library Items

Configure library items for Self Service availability.

Items Available for Self Service

The following library items can be made available to users via Self Service in macOS:

  • Auto Apps
  • App Store Apps (Apps and Books)
  • Managed OS
  • Custom Apps
  • Custom Scripts
  • Custom Printers

In iOS and iPadOS, the following library item can be made available through Self Service:

  • App Store Apps (Apps and Books)

    Enabling Self Service for Library Items

    Once you have Self Service settings configured in the Kandji web app (Settings > Self Service), you can enable individual library items to appear in the Self Service app for your users. In the library item, the Self Service options and customizations will be displayed.

    1. In the Installation pop-up menu, choose either Install on-demand in Self Service or Install and continuously enforce.
    2. Choose an available category in the Category menu.
    3. Select Recommended if you want this item to appear in the Recommended section of the Self Service app.
    4. Click the Edit button to customize the appearance of the item in the Self Service app.

    Customizing a Library Item

    You can customize a library item for Self Service by clicking the Edit button on the item tile in the Customization section. In the Self Service Customization details pane, the following options are available.

    1. Enter a custom name in the Name field. The name will be prefilled from the App Store listing, Auto App item, or library item details.
    2. Enter a short description. This entry will be prefilled from the App Store or Auto App listing. 
    3. Choose an available category from the Category menu.
    4. Select Recommended if you want the item to appear in the Recommended section of the Self Service app.
    5. Enter a long description. This entry will be prefilled from the App Store or will contain the description from the Auto App item.
    6. Select Require users to read the description before installing if you want to ensure that users are presented with that information before proceeding with the installation of the item.

      CleanShot 2021-06-02 at 11.05.08@2x

    Auto Apps 

    Auto Apps can be offered through Self Service in macOS only. 

    • When an Auto App's Installation option is set to Continuously Enforce, you can still optionally show this item in Self Service. This may be useful if users need reinstall the application for any reason. 
    • When an Auto App's Installation option is set to Install on-demand from Self Service, the app will not be installed until the user installs the application from Self Service. 
      • When installing from Self Service, the latest version of the app will be installed.
      • If you configure version enforcement in the Updates section, the Auto App will be updated if the App is currently installed, either via Self Service or other means (such as if the user downloads it manually). 

    Managed OS

    Major macOS upgrades may be offered through Self Service for macOS only.

    • When a Managed OS library item's Installation option is set to Continuously Enforce, you can not show this item in Self Service.
    • When a Managed OS library item's Installation option is set to Install on-demand from Self Service, major macOS versions will not be enforced per the Updates configuration. 
        • When upgrading via Self Service, the latest version of the major macOS version will be installed.
        • When set to Install on-demand from Self Service, the Managed OS item will be displayed in Self Service only when the user's Mac is on a previous major macOS version. 
        • You can additionally configure Updates so that minor macOS updates will be enforced automatically after the end-user has upgraded to macOS Big Sur through Self Service or Software Update.

      App Store Apps (Apps and Books)

      App Store apps may be offered through Self Service in macOS, iOS, and iPadOS. 

      • When an App Store app's Installation option is set to Install and Continuously Enforce, you can still optionally show this item in Self Service. This may be useful if users need to try reinstalling the app for any reason. 
      • When an App Store app's Installation option is set to Install on-demand from Self Service, the app will not be installed until the user installs the application from Self Service.
        • When Installing via Self Service, the latest version of the app will be installed. 
        • Kandji will automatically take over management of licensed applications that are not from the App Store if set to Install on-demand from Self Service, as long as the bundle ID of the existing application matches that of the Apps and Books version. Your global or per-app update settings will be respected. 

      Custom Apps

      Custom apps may be offered through Self Service in macOS only. 

      • When a custom app's Installation option is set to Install and continuously enforce or Install once per device, you can still optionally show the custom app in Self Service. This may be useful if users need to try reinstalling the software. 
      • When a custom app's Installation option is set to Install on-demand from Self Service, the app will not be installed until the user installs the application from Self Service.
        • When a custom app is set to Restart after successful install and installed via Self Service, end users will be given a 5 minute countdown before a restart occurs instead of the 30 minute countdown when run in the background by the Kandji Agent.

        Custom Scripts

        Custom scripts may be offered through Self Service in macOS only. 

        • When a custom script's Execution Frequency option is set to Install once per device, you can still optionally show this item in Self Service. This may be useful if users need to try to rerun the script for any reason. 
        • When a custom script's Execution Frequency option is set to Install on-demand from Self Service, the app will not be installed until the user installs the application from Self Service.
        • When a custom script is set to Restart after successful execution and run via Self Service, end users will be given a 5 minute countdown before a restart occurs instead of the 30 minute countdown when run in the background by the Kandji Agent.

        Custom Printers Considerations

        Custom printers may be offered through Self Service in macOS only.

        • When a custom printer's Installation option is set to Install printer and continuously enforce or Install printer once per device, you can still optionally show the printer in Self Service. This may be useful if users need to reinstall the printer for any reason. 
        • When a custom printer's Installation option is set to Install on-demand from Self Service, the printer will not be installed until the user installs the printer from Self Service.