Installing UniconOS Management

Heading

Lorem ipsum dolor sit amet.

Categories

Overview

UniconOS (formerly eLux) is a secure, lightweight, hardware-agnostic, Linux-based operating system used on managed thin client and repurposed PC endpoints to deliver a locked-down, easily managed user experience for Citrix Virtual Apps and Desktops, DaaS, and other virtual workspace environments.

UniconOS Management (formerly Scout, or “Scout Enterprise Management Suite”) is the server-based console used to provision, configure, patch, and monitor UniconOS endpoints across on-premises and cloud environments. It consists of a Windows service (Scout Server), a management console (Scout Console), a web-based dashboard (Scout Board), and optional add-on components (eLux Container, ELIAS).

This guide covers preparing for, installing, and licensing UniconOS Management. It is based on Citrix’s documentation at docs.citrix.com/en-us/unicon-elux-scout.html.

New Install Preparation

System Requirements

Confirm the target server(s) and admin workstation(s) meet the following minimums before installing.

Component

Requirement

Scout Server & Console OS

Windows Server 2019, 2022, or 2025, fully patched

Scout Console-only OS

Windows 10 or Windows 11

Architecture

64-bit required

Disk space

600 MB minimum for the suite; +5 GB per eLux Container; additional space for ELIAS 18

Memory

8 GB minimum if installing ELIAS 18

.NET Framework

.NET Framework 3.5 and .NET Framework 4.5.1 or later

ODBC driver

ODBC Driver 18, 17, 13, or 11 for SQL Server, or SQL Server Native Client

Database

Microsoft SQL Server 2019 or 2022 (SQL Server Express supported for small deployments)

eLux Container (optional)

FTP or HTTP server role; 5 GB minimum disk space per container

ELIAS 18 (optional)

MongoDB 6, 7, or 8; IIS 8.0+ with the WebSocket Protocol feature enabled

Scout Board browser support

Firefox 136+, Chrome 137+, or Edge 127+; Full HD resolution; pop-ups enabled

 

Firewall Ports

Open the following ports between UniconOS Management and its database, endpoints, and management workstations before installing.

Port

Protocol

Source

Destination

Purpose

1433

TCP

Scout Server

SQL Server

Database connectivity

1434

UDP

Scout Server

SQL Server

SQL Browser service

22123

TCP

Scout Server

UniconOS endpoints

Scout Management (secure)

22125

TCP

Scout Server

UniconOS endpoints

Scout Management (TLS)

22124

TCP

Scout Server

Scout Keep Alive service

Endpoint health monitoring

5900

TCP

Scout Console

UniconOS endpoints

Desktop mirroring

5902

TCP/UDP

Scout Board (web)

UniconOS endpoints

Mirroring UniconOS desktop

80 / 443

TCP

Clients

Web server

HTTP/HTTPS client access and firmware updates

Note: After the initial connection is made, SQL Server dynamically assigns client ports between 1024–5000. Allow outbound traffic from port 1433 to any port in that range, or configure SQL Server to use a static port.

Download the Installer

  • Copy the installer to the server that will host UniconOS Management, or run it from a network share.

  • If you do not already have a SQL Server instance available, install SQL Server (or SQL Server Express for a small/lab deployment) and note the instance name before continuing.

UniconOS Management New Install

Perform these steps on the server that will host UniconOS Management. This is the attended (interactive) installation; an unattended/silent installation is also documented by Citrix for scripted deployments.

Pre-requisites

  • .net 3.5 install
  • IIS default install with WebSocket Protocol enabled (Assuming ELIAS will be installed on the same server)
  • Create a web certificate (Internal Microsoft CA) and bind to IIS default website on port 443.  Make sure the private key is exportable.   You may need to copy the default “Web Server” certificate template in order to make the private key exportable.
  • Create a service account for Unicon and assign as local administrator
  1. Log on to the target server with a local administrator account that also has permissions.
  2. Right-click ScoutInstaller.exe and select Run as administrator.
  3. On the License Agreement page, read the terms, select I accept the terms in the License Agreement, and click Next.
  1. On the License Model page, choose how UniconOS Management will license endpoints:
    1. Citrix License Server – enter the FQDN/hostname of an existing Citrix License Server.
    2. Managed Service Provider mode – for MSPs licensing multiple tenants centrally.
  1. On the Installation Scope page, select Standard for a typical install, or User-defined to customize which features are installed and change the install directory. Click Next.
  1. On the Database Connection page:
    1. Enter the SQL Server machine name and instance.
    2. Choose the authentication type (SQL Server or Windows) and supply credentials.
    3. Configure connection encryption/certificate trust options as required by your SQL Server configuration.
    4. Click Connect, then select or create the Scout database.
    5. Click Next.
  1. On the Initial Settings page, set the initial UniconOS Management administrator credentials and the device password that will be assigned to UniconOS endpoints. Click Next.
  1. On the Scout Board Configuration page (optional), set the port number and computer name used to reach the Scout Board web console and choose the certificate created in the pre-requisites section. Click Next.
  1. On the Scout Keep Alive Service page, configure the TCP port and HTTPS settings, and select an existing SSL certificate. Click Next.
  1. On the Firewall Rules page, review the ports required (see the Firewall Ports table above) and either allow the installer to configure the Windows Firewall rules automatically. Click Next.
  1. On the Installation Summary page, review the selected features and settings, then click Install.
  1. The installer automatically installs required dependencies, including the Visual C++ Redistributable and Microsoft Report Viewer, then installs UniconOS Management.
  2. When the installer finishes, click Finish. Desktop shortcuts are created for Scout Console and Scout Board.
    Note: An unattended/silent installation method is also available for scripted or repeatable deployments – see Citrix’s “Unattended Installation” documentation.
  3. Add “NODE_USE_SYSTEM_CA=1” to the bottom of the .env file (make a copy first)
    C:\Program Files\Unicon\Scout\Scout Board
  4. Run “setx NODE_USE_SYSTEM_CA 1 /M” to set as an environment variable.
  5. Restart the server.

Post-Installation Verification

  1. Launch Scout Board in a supported browser and sign in with the administrator credentials created during setup.   If there are any issues with the certificate, they appear in the backend.log file located in C:\Users\Public\Documents\Unicon\Scout\ScoutBoard.
    Scout Board HTTPS Certificate Setup | Scout Board
  2. In Scout Board, open License information and confirm the expected entitlements are visible and the license status is active.