> Source: https://docs.cyberelements.io/bastion/4.6/Installation/ClientAndAgent/ClientInstallation/

# Installation of the CyberElements Bastion client

The CyberElements Bastion client is installed on the user's workstation and is required for the following actions:

- Compliance checks requiring access to the OS:
    - Anti-spyware
    - Anti-virus
    - MD5
    - Browser
    - OS
    - Firewall
    - System
- Launching applications that cannot be accessed directly from the browser (SSH, RDP, VNC, VPN, or generic tunnel, among others)

## Where can I download the client?

The client is available for download either in the administrator console or on the user portal.

> **Administrator console**
>
> 1. Access the “Configurations” workspace using the button located at the top left: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Open_Configurations_workspace_CLR.png)
> 2. Open the “Toolbox” tile ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Configurations_Toolbox_tile_CLR.png)
> 3. Retrieve the appropriate setup for the desired OS in the first tab, “Integration Tools”![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Configurations_Toolbox_clr_Integration_tools.png)

> **User portal**
>
> 1. Log into the user portal
> 2. Click on the downloads icon located at the top right: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/User_Portal_Select_Downloads_Icon_CLR.png)
> 3. Download the CyberElements Bastion client appropriate for your OS: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/User_Portal_Downloads_List_clr.png)

## Installation of the Microsoft Windows client

> **Administrator rights required**
>
> Administrator rights are required to install the client.

> **Client compatibility**
>
> To find out whether the client is compatible with different versions of Microsoft Windows, refer to [the compatibility matrix](https://docs.cyberelements.io/bastion/4.6/CompatibilityMatrix/).

### Graphical installation

1. Run the `setup_Cleanroom_Client.exe` setup as an administrator (a request to run as an administrator will appear if necessary).
2. Click Next on the first window: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_1st_screen.png)
3. Accept the terms of use: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_2nd_screen.png)
4. On the third screen, specify the installation directory, install Cleanroom Desktop if you want the applications to be displayed on the desktop, and install the OpenVPN components if standard VPN applications are available to the user: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_3rd_screen.png)
5. (If Cleanroom Desktop must be installed) The next window will ask you to complete various settings: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_4th_screen.png)
    - `Server Name`: IP address or DNS name of the Mediation server
    - `Organization`: name of the organization to which the client will connect
    - `Domain`: name of the CyberElements Bastion connection domain
    - `Domain choice`: definition of the control that the user has over the choice of domain; there are three levels:
        1. `force`: the domain selection is forced on the user
        2. `serial`: the client will use cascading authentication for domain selection, so cascading authentication must be configured on the organization
        3. `user`: the user is free to select the connection domain of their choice
6. (If Cleanroom Desktop must be installed) Select whether Cleanroom Desktop should launch automatically when the session opens and whether it should run after installation: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_5th_screen.png)
7. Finally, start the client installation: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_6th_screen.png)

### Silent command line installation

To install the client silently via the command line, four options are available:

1. Installation of the client only:

   ```
   1
   ```
2. Installation of the client + OpenVPN drivers:

   ```
   1
   ```
3. Installation of the client + Cleanroom Desktop components:

   ```
   1
   ```
4. Installation of the client + OpenVPN drivers + Cleanroom Desktop components:

   ```
   1
   ```

When Cleanroom Desktop components are installed, various variables need to be defined:

- `CL_DOMAIN`: name of the CyberElements Bastion connection domain
- `CL_ORGA`: name of the organization to which the client will connect
- `CL_SRV_NAME`: IP address or DNS name of the Mediation server
- `CL_DOM_CHOICE`: definition of the control that the user has over the choice of domain; there are three levels:
    1. `force`: the domain selection is forced on the user
    2. `serial`: the client will use cascading authentication for domain selection, so cascading authentication must be configured on the organization
    3. `user`: the user is free to select the connection domain of their choice

### Extracting the MSI

1. Open a command prompt or PowerShell console
2. Navigate to the folder where the CyberElements Bastion Windows client is located.
3. Run a command similar to the following, customizing the `C:\temp` destination directory if necessary:

   ```
   1
   ```
4. The `Cleanroom Client.msi` client will be available in the directory defined in the previous step

## Installation of the macOS client

> **Administrator rights required**
>
> Administrator rights are required to install the client.

> **Client compatibility**
>
> To check the client's compatibility with different versions of MacOS, refer to [the compatibility matrix](https://docs.cyberelements.io/bastion/4.6/CompatibilityMatrix/).

### Client Installation

1. After downloading the `IPdivaClient.dmg` client, run it.
2. The following window will appear. Drag and drop the client icon into Applications: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_MacOS_1st_screen.png)
3. The installation is now complete, but the first time you use it, you will need to confirm the opening and authorize access to the local network for the client: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_MacOS_3rd_screen.png) ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_MacOS_4th_screen.png)

> **For Macs running on an ARM processor**
>
> When using the client for the first time, the following message may appear, prompting you to install Rosetta. Rosetta must be installed for the client to function. ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_MacOS_2nd_screen.png)

### Installation of VPN components

If you are using VPN applications, another component is required for installation: `IPdivaVPN.pkg`.

1. After downloading the `IPdivaVPN.pkg` client, run it.
2. The setup begins with an introduction that can be skipped without further action: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_VPN_MacOS_1st_screen.png)
3. Then you must accept the terms and conditions: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_VPN_MacOS_2nd_screen.png)
4. Configure the installation for all users: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_VPN_MacOS_3rd_screen.png)
5. If necessary, specify the installation disk for the application: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_VPN_MacOS_4th_screen.png)
6. Confirm the end of the installation: ![](https://docs.cyberelements.io/bastion/4.6/img/Cleanroom/Setup_CLR_Client_VPN_MacOS_5th_screen.png)

## Installation of the Ubuntu client

> **Superuser rights required**
>
> Superuser rights are required to install the prerequisites.

> **Client compatibility**
>
> To find out about the client's compatibility with different versions of Ubuntu, refer to [the compatibility matrix](https://docs.cyberelements.io/bastion/4.6/CompatibilityMatrix/).

1. Download the client suitable for Ubuntu `gateclient_linux_x64*.tar.xz`.
2. Open a terminal and navigate to the directory where the client is located.
3. Install the prerequisites and the client with the following commands:

```
1
2
3
4
```
