Axel: Created dedicated Windows installation guide

2026-08-14T12:09:53Z

Created dedicated Windows installation guide

New page

The '''IBH OPC UA Server/Client''' is installed as a 64-bit Windows application. The setup configures the automatically started <code>ibhopcua</code> Windows service, the tray application and the Web Configurator.

== Workflow at a glance ==
# Download the current 64-bit setup.
# Run the setup with administrative privileges.
# Verify the Windows service and tray application.
# Open the Web Configurator and change the default password.
# Activate the license online or offline.
# Configure and test the OPC UA endpoint and controller connections.

== Requirements ==
* Approved 64-bit Windows system; Windows 10 or Windows 11 is recommended for new installations
* Local administrative privileges for installation
* Static IP address or resolvable hostname recommended
* Network access to the configured controllers
* DNS resolution and HTTPS access to the license server for online activation
* Required TCP ports available or configured

Before updating an existing installation, create a configuration backup and close the tray application.

== Download ==
Download the current 64-bit setup from the official site:

* [https://www.ibhsoftec.com/c/download/ibh-opc-ua-server-client Download IBH OPC UA Server/Client]

Use only an installer from a trusted source and verify the IBHsoftec digital signature if required.

== Installation ==
# Sign in with an account permitted to install software.
# Right-click the setup file and select '''Run as administrator'''.
# Verify the publisher and confirm the Windows security prompt.
# Follow the installation wizard.
# Keep the proposed installation folder unless your system policy requires another location.
# Complete the installation and restart Windows if requested.

The default folder is:

<pre>
C:\Program Files\IBH OPC UA Server-Client
</pre>

The setup installs the <code>ibhopcua</code> service, <code>IBHOpcUATray.exe</code>, the server/client runtime, the Web Configurator and Start menu entries.

== Check the service and tray ==
Open <code>services.msc</code>. The '''IBH OPC UA Server-Client''' service, internally named <code>ibhopcua</code>, should be present and start automatically.

Administrative PowerShell commands:

<pre>
Get-Service ibhopcua
Start-Service ibhopcua
Restart-Service ibhopcua
</pre>

[[File:IBH_OPC_UA_Start_Server.png|thumb|center|600px|Starting the IBH OPC UA Server/Client. The appearance may vary.]]

The tray application provides access to start, stop, the Web Configurator and diagnostics. If the icon is missing, start '''IBH OPC UA Server-Client''' from the Windows Start menu.

[[File:IBH_OPC_UA_Start_Tray.png|thumb|center|350px|Starting the tray application from the Start menu.]]

== Open the Web Configurator ==
Open it from the tray menu or use:

<pre>
http://localhost:48080
</pre>

From another computer:

<pre>
http://IP-ADDRESS-OR-HOSTNAME:48080
</pre>

For an unchanged initial installation:

{| class="wikitable"
! User name
! Password
|-
| <code>admin</code>
| <code>admin</code>
|}

'''Change the default password immediately after the first login.'''

== Network and firewall ==
{| class="wikitable"
! Function
! Default TCP port
! Notes
|-
| Windows Web Configurator
| 48080
| Allow only from required administration networks
|-
| OPC UA Server
| 48010
| Endpoint for OPC UA clients
|-
| HTTPS web access
| according to configuration
| Allow only when HTTPS is configured
|}

MQTT, the integrated OPC UA Client and online activation may require additional outgoing connections.

== License activation ==
The former hardware-ID, email, serial-number and PIN workflow is no longer current.

=== Online activation ===
# Open '''System / Licensing'''.
# Enter the license serial number.
# Enter the associated eight-digit secret.
# Start activation and verify the license status.

=== Offline activation ===
# Generate and download <code>ibhlinkua-license-request.json</code>.
# Process the request using the designated licensing workflow on a computer with Internet access.
# Upload the signed JSON license file.
# Verify the license status.

The license is bound to the Windows computer. See [[IBH OPC UA:Licensing|Licensing]].

== OPC UA connection test ==
<pre>
opc.tcp://IP-ADDRESS-OR-HOSTNAME:48010
</pre>

Add the endpoint to an OPC UA client, verify the server certificate, select the matching security policy and authentication, browse the address space and read a test variable. Write only to variables explicitly intended for testing.

== Update ==
# Back up the configuration.
# Download the current 64-bit setup.
# Run it as administrator over the existing installation.
# Restart Windows if requested.
# Verify the service, license, certificates, projects and controller connections.

Perform a downgrade only after consulting IBHsoftec Support.

== Uninstallation ==
Open '''Settings / Apps / Installed apps''', select '''IBH OPC UA Server-Client''' and start uninstallation. Back up configuration, certificates and licensing information before removing remaining data.

== Troubleshooting ==
; Setup does not start
: Check administrative privileges, digital signature, Windows version, antivirus software and system policies.

; Service does not start
: Check <code>services.msc</code>, Windows Event Viewer and port conflicts.

; Tray icon is missing
: Start the tray application from the Start menu and check hidden taskbar icons.

; Web Configurator cannot be reached
: Check the service, TCP port 48080, local URL and Windows Firewall.

; OPC UA client cannot connect
: Check endpoint, port 48010, system time, certificates, security policy and user authentication.

; Online activation fails
: Check Internet access, DNS, proxy, firewall, system time, serial number and the eight-digit secret.

== Next steps ==
* [[IBH OPC UA:Startup operations|Startup and commissioning]]
* [[IBH OPC UA:Installation on Linux|Installation on Linux]]
* [[IBH OPC UA:Licensing|Licensing]]
* [[IBH OPC UA Editor]]
* [[IBH OPC UA:Manual|Manual overview]]

IBH OPC UA:Installation on Windows - Revision history

Axel: Created dedicated Windows installation guide