Skip to main content
Version: v2


Let's install OIBus in less than 2 minutes.


To operate, OIBus must be installed on an environment with the following minimum characteristics:

  • 64 bits architecture. 32bits and ARM architectures are not supported.
  • RAM: 2GB minimum. OIBus may require more RAM depending on the configuration of South and North connectors.
  • Disk space: 200 MB. For the application. It is however recommended to have extra space (several GB, depending on your data stream) to store the collected data in the cache if an upstream network failure occurs.
  • Admin rights on the environment to install OIBus and register it as a service (for Windows and Linux).
  • Modern web browser (IE not supported). Used to access the OIBus configuration interface. The browser can be on the targeted computer or on another, provided you have configured the necessary access.

Installation steps


With the Windows Installer

  1. Run the Windows Installer, you should see the following welcome screen:

Installer welcome screen

  1. Accept the EU-PL license and the OPCHDA license.

  2. Choose the path where you want to install the binaries.

Installer binaries path

  1. Choose the path where you want to store the cache, logs and configuration files

Installer data folder path

  1. The next step offers you to tune the following OIBus settings:
  • The OIBus name (default OIBus)
  • The admin name (default admin)
  • The port to use (default 2223)

Installer settings

  1. Validate the settings and wait for the installer to extract and copy the files in the appropriate folder.

Installer validation step

  1. The final screen confirms the installation. You can click on the link at the bottom to directly access OIBus from its web interface.

Installer final step

Browser support

Note that Internet Explorer is not supported.


With the Windows Installer

In case of OIBus update, you can use the OIBus Windows Installer and specify the already existing executable and config path. You can choose to keep the existing configuration file or overwrite it.

During the update, OIBus service will be stopped briefly.

The configuration file oibus.json will be updated to its latest version during the first startup.

With binaries

Alternatively, you can download the zip file containing the OIBus executable and other dependencies.

  1. Go to the Windows service manager.
  2. Stop the OIBus service.
  3. Copy and paste the content of the zip file into the OIBus executable folder. Overwrite all existing files.
  4. Start the OIBus service.

The configuration file oibus.json will be updated to its latest version during the first startup.

Access OIBus interface

OIBus configuration interface is available on http://localhost:2223 (assuming the default port has been kept).

Default access

By default, the user is admin and the password is pass.

We strongly advise to change the password in the Engines settings.

When installing OIBus, remember to choose an appropriate name. The Engine name is important mainly if you use several OIBus and send the logs to a remote loki instance.