Installation

Platform Connectors is available as a windows installer that sets up a Windows service hosting the web server. It can be installed on any machine that can connect to the systems it needs to communicate with. Refer to each plugin documentation for specific connectivity requirements.

Download the installer using this link.

Prerequisites

  • Windows 10/11 or Windows Server 2016+

  • Administrator permissions to install software and manage Windows services

  • Optional: Allow inbound traffic on the HTTP(s) port you plan to use (default 8000)

Installation

  1. Run the setup installer as an administrator and follow the prompts.

  2. When installation completes, a Windows service is installed and configured to start automatically.

Default web address

After installation the web server runs as a Windows service and is reachable at:

http://localhost:8000

If you changed the host/port (see below), use the updated address.

Using SSL

A folder called default-ssl is provided alongside the installation in C:\Program Files (x86)\Platform Connectors. This folder contains a self-signed certificate that you can use for ssl communication.

To enable browsing using https, rename default-ssl to ssl so the service loads the bundled certificate, or create a new ssl folder and place your own certificate and private key there. The files must be named cert.pem and key.pem.

After updating the certificate files, restart the windows service so the server picks up the change.

Web Server Configuration

Configuration lives in: C:\Program Files (x86)\Platform Connectors\appsettings.json

  • HostIp: IP address the server binds to (use 0.0.0.0 to listen on all interfaces, or 127.0.0.1 for local-only)

  • Port: HTTP(s) port (default 8000)

  • ConfigDir: Path to the configuration directory used by the application/plugins (default: C:\ProgramData\Platform Connectors)

To change settings:

  1. Stop the service using windows Services

  2. Edit appsettings.json as an administrator (files under Program Files (x86) require elevation)

  3. Save your changes

  4. Start the service again

  5. If you changed the port or host, update any firewall rules accordingly

Onboarding flow

  1. Start the Windows service (already installed during setup).

  2. Visit http://localhost:8000 (or your configured host/port).

  3. A default Super Admin workstation is created with ip localhost and no password. The onboarding process must be completed from the localhost workstation. The onboarding process includes: - Applying a new password for the Super Admin workstation. - Uploading a valid license file.

  4. Once the onboarding process is completed, the user can proceed with setting up a new plugin or registering additional workstations.

Upgrade

  • Run the newer installer and follow the prompts

  • Navigate to the host url from an Admin workstation (or from the local machine using localhost).

  • Enter the workstation password.

  • Click Update license button in the system settings page and upload the new license file.

Uninstall

  • Use “Apps & features” (Windows 10/11) or “Programs and Features” to uninstall “Platform Connectors”.