Skip to main content
Skip table of contents

IGEL App Creator Portal

With the IGEL App Creator Portal, you can create apps for IGEL OS 12 by using a recipe and, depending on the case, one or more binaries. The recipe contains the scripts and metadata files necessary to build an app that can be installed and run on the IGEL OS Base System. IGEL, IGEL customers, the IGEL community, or IGEL Technology Partners can provide the recipe.

Legal Note

IGEL is not responsible for, nor does it grant a license to, the applications created via the App Creator Portal.
IT IS YOUR SOLE RESPONSIBILITY TO OBTAIN ALL NECESSARY RIGHTS TO THE COMPONENTS PRIOR TO CREATING AN APPLICATION.

For more information, see our Terms and Conditions:
https://www.igel.com/terms-conditions/

In addition, the App Creator Portal will sign your app and provide the corresponding certificate. When you deploy this certificate to the device, the IGEL OS Base System will allow the app to be installed. Please note there are two types of certificates:

  • If your company has IGEL Enterprise Edition licenses, you receive a certificate exclusively for your company. With a company certificate, the apps you have created can only be installed on your company’s devices.

  • If your company has one of the other licenses, you receive a Community certificate. With a Community certificate, your created apps can be installed on any device.

image-20240910-092529.png

Access to the IGEL App Creator Portal

To log in to the IGEL App Creator Portal, you need an account and have the App Creator role or the Super Admin role assigned. This is done in the IGEL Customer Portal. For details, seeManaging Users and Roles in the IGEL Customer Portal.

Requirements

  • UMS 12.04 or higher

  • IGEL OS 12.5 or higher

  • The recipe for your app

  • The binary/binaries for your app, if required

Login to the IGEL App Creator Portal

  1. Go to https://appcreator.igel.com

  1. Click Login.

image-20240910-092607.png

  1. Enter your IGEL credentials.

image-20240910-092659.png

The landing page of the App Creator Portal is shown.

image-20240910-084816.png

Every time the page refreshes, all data is cleared and a new isolated session is created in the backend.

Creating the App in the IGEL App Creator Portal

Providing the Recipe

You can provide a recipe by uploading a package file or cloning a Git repository. In the following, we will upload a package file.

Before you upload a package, you may want to check or edit the metadata contained in the following files:

  • app.json should contain the correct version and name for your app.

  • igel/thirdparty.json must contain the names of the binaries used in your app.

You can find a comprehensive description of the metadata at https://github.com/IGEL-Community/IGEL-OS-APP-RECIPES/blob/main/utils/IGEL-SDK-Reference-Manual.pdf- please note this document is primarily aimed at developers who use the IGEL OS App SDK.

  1. Drag & drop your file on the field Upload Package.

image-20250129-081405.png

The name and size of the file are displayed.

image-20250129-081447.png

  1. Click Upload.

image-20250129-081700.png

The recipe is uploaded and processed.

image-20240911-091359.png

When the recipe has been processed successfully, it is displayed in the right column, and the Create button is active.

image-20250129-083550.png

For information on cloning a Git repository, see the following links:

Providing the Binary/Binaries

This section is relevant if your app requires one or more binaries. If no binary is needed, continue with Creating the App.

If you upload only a binary, but no recipe, no app will be created.

  1. Put your binary archive / binary archives into a Zip file.
    This step is necessary because the App Creator Portal expects a zip file with one or more binary archives inside and performs a corresponding unzipping routine.
    Example: To upload the binary archive, e.g. mybinary.tar.gz or mybinary.deb, to the App Creator portal, you must first zip it, although it is already an archive file.
    The contents of the outer zip file can have the following formats:

    • .tgz

    • .gz

    • .zip

    • .deb

    • .bz2

  1. Drag & drop your file on the field Upload Package.

image-20250129-084610.png

  1. Click Upload.

image-20250129-084809.png

The binary archive is uploaded and processed.

image-20250129-085014.png

When the binary archive has been processed successfully, it is displayed in the right column.

image-20250129-092730.png

Building the App

  1. In the right column, click Create.

image-20250129-093109.png

  1. Review the legal notice in the Notice dialog. If you are sure that all conditions are met, click Acknowledge to proceed.

image-20250129-093321.png

The build process starts

image-20250129-093355.png

  1. Once the build process is finished successfully, click Download.

image-20250129-093537.png

Once downloaded, the uploaded data will be removed after 9 seconds.

image-20250129-093619.png

Downloading the Certificate

The certificate is required for installing the app on your endpoint devices.

→ Download the certificate from the IGEL App Portal.

image-20250129-114715.png

You can now deploy the certificate file to your endpoint devices. For instructions on deploying files with the UMS, see Files - Registering Files on the IGEL UMS Server and Transferring Them to Devices (use App signing certificate as the file type). Alternatively, you can deploy the license file locally on the device.

Troubleshooting: Downloading the Log File

→ If something has gone wrong during the build process, download the log file for debugging.

image-20250129-095123.png

View Your User Details

→ To view your user details, click on the corresponding button.

image-20250129-123345.png

Your user details are displayed in a dialog window.

image-20250129-123532.png

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.