Installing enaio® webclient as a desktop application

By default, enaio® webclient allows users to download the enaio® webclient as a desktop application installer, enaio-webclient-app.exe, via the user menu.

It can be installed for the user only or globally for all users. Global installation requires administrator rights.

The path can be specified during installation.

If there is also an update for enaio® webclient as a desktop application after enaio® webclient has been updated, then an update will be performed automatically when enaio® webclient as a desktop application is started.

The enaio® webclient download feature can be disabled via the following parameter:

config.webclient.featureSwitches.desktopApp.download

Installation Requirements

Before installing enaio® webclient as a desktop application, the Microsoft Visual C++ Redistributable Package and the .NET framework must be installed in the version corresponding to your operating system language. All necessary installation resources are available in the 'Prerequisites' area of the Service Portal if these system requirements are not already automatically present.

Installing as an Administrator

The MSI package for installation as an administrator has been discontinued and is no longer available for enaio® webclient with Service Release 2 Hotfix 18. The NSIS installer enaio-webclient-app.exe is used instead. The NSIS installer also allows you to allocate profiles for user-specific installations via the init-profiles.json configuration file.

Installing as an Administrator via NSIS Installer

The NSIS installer enaio-webclient-app.exe used to install enaio® webclient as a desktop application as an administrator via the command line is located in the installation data in the \Frontend\Webclient-Desktop-App\ directory.

Installation Parameters for enaio-webclient-app.exe

Parameter	Function
/S	Silent mode
/CurrentUser	User-specific installation User-specific installations are installed in the following directory: C:\Users\<Benutzername>\AppData\Local\Programs\enaio webclient
/AllUsers	Global installations
/P	Optional application parameters
/D	Target directory for global installation A target directory is required for global installations.

Example: enaio-webclient-app.exe /S /AllUsers /P=--disable-accelerated-2d-canvas /D=C:\enaio\webclient

The target directory for global installations must be specified last.

Profile allocation is possible with user-specific installations.

If an init-profiles.json configuration file is available in the enaio-webclient-app.exe directory, the profiles for connecting and logging in are automatically integrated from the configuration file.

Profile allocation is possible with global installations.

Parameters of the init-profiles.json Configuration File:

profiles	Multiple profiles can be specified.
activate	true/false If several profiles have this property, the most recent one from the configuration is preselected in the dialog.
url	URL to enaio® gateway
username	User name Useful only for DEMO installations
password	Unencrypted password Useful only for DEMO installations
autologin	true/false Enable/disable 'Log in automatically'
authType	NTLM_SYSTEM for Windows login BASIC_AUTH for login using enaio® data OPENRESTY_KEYCLOAK for logging in with OpenResty/Keycloak A NTLM_SYSTEM login with automatic login enabled allows the Windows user to login automatically.

A configuration file, which you can use as a template, is available for download:

init-profiles.json

Uninstalling

Installations are uninstalled via the Windows Control Panel.

Update

Installations can be updated via the NSIS installer.

enaio® webclient as a desktop application will be automatically updated for users following the enaio® webclient update.