---
title: "Install and Configure On-Premise Connector on an Ubuntu machine"
slug: "install-and-configure-on-premise-connector-on-an-ubuntu-machine"
description: "Learn how to install and configure Scalefusion's On-Premise Connector on an Ubuntu machine. This guide covers the installation steps, requirements, and best practices for Ubuntu users."
updated: 2026-03-19T11:12:04Z
published: 2026-03-19T11:12:04Z
canonical: "help.scalefusion.com/install-and-configure-on-premise-connector-on-an-ubuntu-machine"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.scalefusion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install and Configure On-Premise Connector on an Ubuntu machine

The OPC connector being an .msi file, could only be installed on Windows machines. However, with WineHQ, Scalefusion's On-Premise Connector can also be set up and installed on Ubuntu machines. The WineHQ software acts as a bridge by providing a compatibility layer for running Windows applications on Linux-like operating systems.

To start using the On-Premise Connector, the first step is to configure it. Configuring it requires the flow to be started from the Scalefusion Dashboard and continued on-premise with required information exchanged between the two, that is, the Scalefusion Dashboard and the On-Premise Connector instance.

The document below describes the process to install On-Premise Connector on Ubuntu 22.04 LTS for desktop.

## Prerequisites

1. Scalefusion Account with Enterprise License (Legacy, Modern or Trial).
2. The administrator should have owner or co-account owner privileges to complete the setup.
3. Any other administrator (Group Admin, Device Admin or in a custom role) who has write access can also do the setup.
4. Ubuntu Desktop 22.04 LTS

## Overview of Setup

In a nutshell, the following is the process for OPC Setup:

1. **Download** OPC's .msi file from Scalefusion Dashboard
2. Install **WineHQ**, which provides a compatibility layer for running Windows applications on Linux-like operating systems.
3. Install **PlayOnLinux**, a graphical frontend for the Wine software compatibility layer, which allows Linux users to install Windows-based applications on the Linux platform.
4. Follow the steps on PlayOnLinux to install the .msi file on the Ubuntu machine and to create an OPC Instance.
5. Login to the **OPC Instance** and choose an appropriate Network Configuration scheme
6. **Configure On-Premise Connector** **Details** on Scalefusion Dashboard
7. **Check Connection** to validate the connection between Scalefusion Dashboard and OPC Instance
8. Set-Up **On-Premise Connector Certificates**. To do so:
  1. **Generate CSR** from the OPC Instance
  2. **Upload** .csr file on Scalefusion Dashboard to generate a signed identity certificate
  3. **Download** the signed identity certificate from the Scalefusion Dashboard
  4. **Upload** the signed identity certificate to the OPC Instance
  5. **Download** the trust certificate from Scalefusion Dashboard
  6. **Upload** the trust certificate to the OPC Instance
9. Directory (LDAP) Configuration on OPC Instance
10. **Complete Setup** on Scalefusion Dashboard

The steps are explained in detail below.

## Setting up On-Premise Connector (OPC) on Scalefusion Dashboard

### Step 1: Download and Install On-Premise Connector .msi file

#### Download

1. On the Scalefusion Dashboard, navigate to **Integrations > On-Premise Connector**
2. Click **Configure![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/3-1%20(1).png)**
3. The On-Premise Connector configuration page opens. Click on the **Download** button to download the On-Premise Connector file![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/4-1%20(1).png)
4. Once the download is complete, copy the **opc-installer-<version>.msi** file to a server within your premises that can access your on-premise resources like Microsoft Active Directory, Microsoft Exchange, etc.

#### Install On-Premise Connector file on Ubuntu 22.04

1. Install [WineHQ](https://wiki.winehq.org/Ubuntu) on your Ubuntu machine.
2. Next, Install **Play On Linux**. This will allow Linux users to install the OPC installer and extract all the executables required to run OPC on the Linux platform. To install Play On Linux, execute the following command on the terminal:MarkupMarkup 

```markup
sudo apt install playonlinux
```
3. Open the Play On Linux application.
4. You will be presented with a manual installation wizard. Click on the **Next** button and proceed to follow the given instructions in order to set up a virtual drive.![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image%20-%202023-09-14T141721.940.png)
5. The steps will involve:
  1. Providing a name for the virtual drive as **Scalefusion OPC**.
  2. Next, select the following: **Configure Wine** and **Use a different version of Wine**.
  3. Choosing the **System** version of Wine.
  4. Selecting the kind of virtual drive you wish to create, select **32-bit Windows installation**.![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image%20-%202023-09-14T142210.956.png)
6. Once Virtual Drive is created, you will get the **Wine Configuration**window. Here,
  1. Select **Default Settings**
  2. In the Windows Version drop-down, select **Windows 10**.
  3. Click **Apply![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image%20-%202023-09-14T142214.005.png)**
7. Next, choose the installation file to execute.
  1. Look for the OPC installer file (.msi) that you downloaded from the Scalefusion Dashboard (Step #1 > Download above) and choose it.
  2. The installation process will commence.
  3. The OPC Setup wizard window will appear. Click on **Next**.
  4. Click on **Install** to initiate the installation.![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image%20-%202023-09-14T142257.383.png)
8. The **PowerShell Setup wizard** will appear. Follow the instructions displayed on the screen to install PowerShell. Finally, click on **Finish** to exit the setup wizard.![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image%20-%202023-09-14T142300.230.png)
9. The OPC Setup Installation Progress will continue. When the installation is towards completion, a message will be displayed **On-Premise Connector setup is ready**. Notice **.exe** file is created.![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image%20-%202023-09-14T142343.093.png)
10. Next, Choose **OPC.exe** from the list for creating a shortcut and enter a **shortcut name** in the next screen. Click **Next![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image%20-%202023-09-14T142345.970.png)**
11. Next, choose **opc-ui.exe** from the list to create a shortcut and give a shortcut name on the next screen. After giving the shortcut name, click **Next![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image%20-%202023-09-14T142422.426.png)**
12. Now, select **I do not want to make another shortcut** and click **Next**
13. The window with both shortcuts will show up. Click on **Configure** on the top.![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image%20-%202023-09-14T142424.959.png)
14. **PlayOnLinux Configuration** window will come up displaying the virtual drive (Scalefusion OPC as configured above) and OPC installation files under it.![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image%20-%202023-09-14T142504.230.png)
15. Select **Scalefusion OPC**to configure. On the right side, there are a few tabs:
  1. **General:** Displays the virtual drive name, Wine version as created.![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image%20-%202023-09-14T142507.113.png)
  2. **Wine:** Under this, click on **Windows Reboot**.![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image%20-%202023-09-14T142545.074.png)
  3. Next, click on **Task Manager** under the Wine tab. In the Task Manager window, **Processes** will show opc.exe and opc-ui.exe running.![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image%20-%202023-09-14T142547.993.png)
16. If the setup is successful, then the On-Premise Connector Instance's Admin UI will open with the URL [http://localhost:28626/opc-ui](http://localhost:28626/opc-ui) on the default browser.![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/opc-ui-1%20(1).png)
17. On the Scalefusion Dashboard, click **Next![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/4-2%20(1).png)**

### Step 2: Configure the On-Premise Connector Instance

The On-Premise Connector Instance can be configured once you have made the necessary network configurations to allow reachability of the On-Premise Connector Instance from Scalefusion Dashboard either via the Reverse Proxy scheme or directly. You may refer to this document for further details. Kindly ensure such network configuration is in place before proceeding ahead.

1. On the host machine where the **OPC Instance** is created, follow these steps:
  1. Login to the OPC instance using the credentials
    1. **Username:**
      1. If you are using On-Prem Connector v2.3.10 or lower
        1. admin@local
      2. If you are using On-Prem Connector v2.3.11 or higher
        1. sf-admin@local
    2. **Password:** Aur0r@dm!n  
**NOTE: You can change the password later in the Log-In Settings of the On-Premise Connector![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/9%20(2).png)**
  2. Under **Network Configuration**, Choose one connection method from the following:
    1. Web-Server or Reverse proxy (e.g.: IIS): Selected by default
    2. Static Public IP![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/10-1%20(1).png)
  3. The **next** button will get enabled once you configure **On-Premise Connector Details** on the Scalefusion Dashboard![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/11-2%20(1).png)
2. Switch to Scalefusion Dashboard and enter the following details:

| **Field** | **Description** |
| --- | --- |
| Scheme | Choose one from among the following: - HTTP (Selected by default) - HTTPS |
| Enter the IP Address / Domain Name where the On-Premise Connector can be reached | The public IP address of the server where the OPC Instance is created if the HTTP scheme is selected. The public DNS name if the HTTPS scheme is selected. |
| Enter the Port number for inbound connections if the default has been changed | This is set to 28767 by default if the HTTP scheme is selected. Unless instructed specifically, you should not change this port. This is set to 443 by default if the HTTPS scheme is selected. |
3. ![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/check-connectio%20(1).png)
4. The **check Connection** button will be enabled after entering the required details. Click on **Check Connection** which would trigger a connectivity check with OPC Instance using the details provided
5. Once the connection between Scalefusion **Dashboard** and **OPC Instance**is validated, the following will reflect:
  1. On the Scalefusion Dashboard, the button changes from Check Connection to **Next**
  2. The next button on **OPC Instance > Network Configuration** (mentioned in Step #1.c above) will also be enabled.![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/next-buttons%20(1).png)

### Step 3: Set Up On-Premise Connector Certificates

You need to set up On-Premise Connector certificates to enable encrypted communications for secure data exchange between Scalefusion Dashboard and OPC Instance. Follow these steps:

1. In the On-Premise Connector Instance, click **Next** at the Network Configuration step, which takes you to Step 2, that is, **Set Up** **On-Premise Connector Certificates**
  1. Here click on the **Generate CSR** button to generate a **Certificate Signing Request (CSR)** file![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/14-1%20(1).png)
  2. This opens up a dialog where you need to enter server/host information where the OPC Instance is hosted.
    1. **Hostname:** The IP address or hostname of the server where the OPC Instance is created
    2. **Department:** The department "OU" that is managing the OPC Instance
    3. **Organization:** Name of the Organization "O" licensed to host OPC Instance
    4. **City:** City "L" where the OPC Instance is hosted
    5. **State/Province:** Name of the State "ST" where the OPC Instance is hosted
    6. **Country:** Name of the Country where the OPC Instance is hosted
  3. Click **Submit![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/generate-csr%20(1).png)**
  4. This will generate and download the CSR file on your local machine (with extension .csr).
2. On the **Scalefusion Dashboard**, upload the same CSR file (downloaded on your local machine) either by dropping the CSR file here or by Selecting Browse Files. This will generate a signed certificate.![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/17-1%20(1).png)
3. Notice that the Download button will get activated under both sub-sections viz. On-Premise Connector Certificate and Trust Store Certificate.
4. Click on the Download button under the On-Premise Connector Certificate sub-section to download the **Identity Certificate**.
5. Click on the Download button under the Download Trust Store Certificates sub-section to download the **Trust Certificate**.![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/20-1%20(1).png)
6. On the **OPC Instance**, first, upload the Identity Certificate.![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/21-2%20(1).png)
7. Next, upload the Trust Certificate.![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/23-trust-certificate%20(1).png)

### Step 4: Directory Configuration on OPC instance

After uploading the certificates, the next step is to configure directory settings in **OPC Instance**. This enables Scalefusion Dashboard to read the users' and group's information.

1. Enter the following under Directory Configuration  
Some fields are pre-filled as hints for understanding. These should be replaced with actual data.

| **Field** | **Description** |
| --- | --- |
| LDAP Hostname | The hostname/IP address where the Active Directory service is hosted |
| LDAP Port | Port number of Active Directory service listening for LDAP connections |
| Domain | Active Directory Domain Name Prefix (the one that is provided when logging on to Windows workstations.) |
| LDAP Admin Username | Active Directory Admin's username for LDAP binding |
| LDAP Admin Password | Active Directory Admin's password for LDAP binding |
| LDAP Directory search base | Define the scope of users and groups i.e. the Organization Units (OU's) that Scalefusion will be able to read. |
| User Login search base | Specify a Security Group that contains users who can access to OPC Instance's Admin UI. The access can be controlled via the User Management section from the 3 dots menu in the OPC Profile. |
2. Click **Submit ![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image-1723804516065.png)**
3. You will land on the Basic Configuration page, which indicates that the integration with OPC is complete. The Basic Configuration page displays basic details like primary email, setup date, certificate details etc.  
![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image-1723803887480.png)

### Step 5: Complete Setup on SF Dashboard

On Scalefusion Dashboard, click **Complete Setup**.![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/26-1%20(1).png)

This completes the setup and displays the OPC configuration details in a single view:

- Connector IP, Port, Version
- Configuration Date
- Configured by
- Status
- Configuration Info: The directory configuration that has been set in OPC Instance.  
![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image-1723804030310.png)

Clicking on **View Details** to show the Organizational Units and Security Groups

![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image-1723804177353.png)

## Actions on Configurations

The following actions can be performed over configuration:

1. **Sync:** If you want to do a manual sync with OPC Instance, click on Sync
2. **Edit Config:** Allows you to edit the scheme, port or IP
3. **Renew Certificate:** There will be an option to renew certificates if they have expired. Click on Renew and follow the same Steps to update the certificates.
4. **Delete:** Deletes the complete OPC configuration. When you click Delete, a confirmation box will appear. Click **Confirm**.

## Management of On-Premise Connector Instance

OPC Instance consists of the following sections when you log in after the initial setup is complete

1. **Setup Configuration:** This consists of two sections
  1. **Basic Configuration -** Displays all basic configurations that have been done in sync with Scalefusion Dashboard
  2. **Network Configuration -** View the network configuration options to establish a connection between the Scalefusion Dashboard and the OPC Instance.  
![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image-1723804297789.png)
2. **Directory Configuration**
  1. **Directory Visibility Info -** Shows the list of OU's and Security Groups that would be visible to the On-Premise Connector, based on Directory Configuration. The users from these groups can be searched and synced with Scalefusion Dashboard.
  2. **Directory Configuration -** The directory settings that have been configured. These can be edited.  
![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image-1723804388572.png)
3. **Manage Users -** Manage the users who are allowed to access OPC UI. Users can be Read+Write (Admin) or Read-Only (User). The User Login Search Base in the Directory Configuration must be defined.

Compatibility WarningOn-Prem connector software is built to be deployed on Windows server machines. It is not built natively for Linux flavours and hence this document is on a WYSIWYG purposes. Scalefusion will not be able to provide technical support or implementation help beyond this guide.