Skip to main content
Skip table of contents

Installing macOS Clients Locally Using the Command Line

This type of installation allows you to install macOS Clients locally from the command line.

To install the macOS Client on a target computer running the macOS operating system from the command line, do the following:

1. Copy the downloaded standard EkranSystemMacOSClientuniversal.tar.gz (or custom EkranSystemMacOSClientuniversal.tar.gz, containing the settings.ini file) installation package to any folder on the macOS system.

2. Run the terminal.

3. Navigate to the folder with the macOS installation package by entering the following command:

cd path/to/folder

4. Unpack the macOS installation package by entering the following command:

tar xvfz <installation package name>

5. Open the EkranClient folder.

6. Enter the following command to run the Ekran System Client application, specifying the host name or IP address of the computer which the Application Server is installed on, and the port to be used for connection to the Application Server (if the port parameter is omitted, the default port 9447 will be used), as well as the tenant key of the tenant that the Client needs to be installed on if Multi-Tenant mode is enabled:

sudo ./ -h <server host name / IP address> [-p <port>] [-t <tenant>]

NOTE: Multiple server host names / IP addresses can be entered, separated by semicolons (e.g. <server host name1 / IP address1;server host name2 / IP address2;server host name3 / IP address3>.

NOTE: For SaaS deployments, the host name / IP address of the load balancer on the Ekran System proxy server should be used for the "-h" argument.  

NOTE: In Multi-Tenant mode, the tenant key can be copied from the Management Tool (on the Tenant Management page) by the administrator of the default tenant. If a tenant key is not specified, the Client will be installed on the built-in default tenant.

Instead, if the EkranClient folder in the macOS installation package contains a settings.ini file, the script needs to be run without adding any parameters.

7. The Accessibility and Screen Recording permissions for the EkranAgentClient application need to be granted to ensure the correct functioning of the Client. To check that these permissions are granted, make sure that the EkranAgentClient checkbox is selected for these permissions, as follows:

 For macOS 12 (Monterey), open System Preferences, and click Security & Privacy, and then click Privacy.

 For macOS 13 (Ventura) or higher, open System Settings, and click Privacy & Security, and then check the permissions on the Accessibility and Screen and System Audio Recording tabs.

8. After installation is complete, the macOS Client will be displayed in the list of Clients on the Client Sessions tab (on the Client Management page) in the Management Tool.

For SaaS deployments, after installing the Client locally, it is then recommended to also trust the root certificate on the macOS Client computer (for SaaS deployments).

JavaScript errors detected

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

If this problem persists, please contact our support.