Skip to main content
Skip table of contents

How to Install the IGEL Cloud Gateway

This article describes how to Install the IGEL Cloud Gateway (ICG) in the IGEL Universal Management Suite (UMS) version 6.02 or lower. For instructions using a newer UMS version, see Installing the IGEL Cloud Gateway.


  1. Start the UMS Console.

  2. Go to UMS Administration > UMS Network > IGEL Cloud Gateway.

  3. In the toolbar in the upper right, click the  icon (Install new IGEL Cloud Gateway).
    The ICG remote installer opens.

  4. Select the certificate you wish to use, then click Next.

  5. Read the EULA and check Accept license if you accept, then click Next.

    image-20240610-184824.png

  6. Enter the installation parameters:

    • SSH host: Address of the host the ICG is to be installed on. This field is prepopulated with a host that has been derived from the certificate. If more than one hosts are specified in the certificate, ensure that this is the one that is used for communication between UMS and ICG.

    • SSH port: SSH port (Default: 22)

      The SSH user needs root privileges, otherwise the remote installer will not be able to perform all required installation tasks.

      UMS 5.09.110 or higher: It is sufficient for the SSH user to have sudo privileges.

      Root access to the SSH server is a security risk!

      If you permit root login for SSH, it is recommended to disable root login when the ICG installation has finished.

      Key-based authentication is not supported by the remote installer. If you are using key-based authentication, you will have to install manually, see Installing the ICG without remote installer.

    • SSH user: The user that remote installer uses to authenticate against the SSH server and execute the installer

    • SSH password: Password for the user specified as SSH user

    • Installation path: Installation path on the server (Default: /opt/IGEL/icg)

    • ICG port: The port number the ICG will be listening on (Default: 8443)

    • Path to installer: The local path to the .bin file containing the installer

      ICG installers are available from https://www.igel.com/software-downloads/.


  7. Click Next.

    image-20240610-184906.png


    The ICG is now being installed. This may take a few moments.

    image-20240610-184928.png

  8. When the installation has finished, click Next.

    image-20240610-184948.png

  9. Enter a display name and the connection details for the ICG:

    • Displayname: The name used for listing the ICG under UMS Administration > IGEL Cloud Gateway.

    • Host: Internal host used by the UMS for connecting to the ICG.

    • Host (external): External host used by endpoint devices to connect to the ICG; only required if the devices use a separate address, not the one specified under Host.

    • Port: Port used by the endpoint devices if they connect to the ICG using the address provided under Host (external). If the devices use the address under Host, this field can be left empty. 

  10. Click Next.

    image-20240610-185027.png

  11.  If desired, you can now define a proxy. Make your settings as required.

  12. Click Finish.

    image-20240610-185055.png


    The newly installed ICG is now listed under UMS Administration > IGEL Cloud Gateway.

    image-20240610-185112.png

  13. To review the status of the ICG and basic data about the installation, go to UMS Administration > IGEL Cloud Gateway > [display name of your IGEL Cloud Gateway].


Video Tutorial



JavaScript errors detected

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

If this problem persists, please contact our support.