Install on Windows
The Windows sink runs as a Windows Service and survives reboots automatically. It supports self-updating — when your administrator publishes a new version, the service downloads and installs the update without manual intervention.
Prerequisites
Section titled “Prerequisites”- Windows 10 / Windows Server 2016 or later
- The provided installer (
nexomatic-remote-setup-windows-x86_64.exe), which bundles its runtime — no Python installation needed - Network connectivity to the Hub host and port (outbound TCP — no inbound rules needed)
- Administrator privileges on the machine
- A node created on the Nodes screen, with its Client ID and Client Secret (see Node Credentials)
Installation via Installer
Section titled “Installation via Installer”The recommended approach is to use the Inno Setup installer provided by your administrator.
Step 1 — Run the installer
Section titled “Step 1 — Run the installer”Double-click the .exe installer and follow the wizard. You will be prompted for:
| Field | Value |
|---|---|
| Hub Host | Hostname or IP of the Hub (e.g. hub.example.com) |
| Hub Port | Port the Hub listens on (default 50051) |
| Hub TLS | Checkbox — encrypt the gRPC connection (required for the platform’s public Hub) |
| Client ID | The node’s Client ID from the Nodes screen |
| Secret | The node’s Client Secret (shown once when the node is created) |
| Script Root Folder | Optional folder with your own shell scripts |
| Authentication Method | client_credentials, entra_id, google, github, or none |
| Tenant ID | Your tenant id |
| Update Base URL | Optional self-update channel (e.g. https://releases.example.com/nexomatic-sink) |
| Node Tenant UUID (optional) | Pin the sink to a single tenant |
| Node Tenant Secret (optional) | Node registration secret |
Step 2 — Verify the service
Section titled “Step 2 — Verify the service”Open Services (services.msc), find Nexomatic Remote Sink, and confirm it shows Running.
You can also check from PowerShell:
Get-Service -Name NexomaticRemoteSinkStep 3 — Confirm in the UI
Section titled “Step 3 — Confirm in the UI”Within a few seconds the sink should appear as ONLINE on the Sinks screen in Nexomatic.
Manual Installation
Section titled “Manual Installation”If you need to install without the wizard (e.g. in a scripted deployment), follow these steps.
Step 1 — Place the files
Section titled “Step 1 — Place the files”Copy the sink files to a directory, for example C:\Program Files\Nexomatic Remote Sink\.
Step 2 — Set environment variables
Section titled “Step 2 — Set environment variables”The service reads its configuration from the Windows Registry under:
HKLM\SYSTEM\CurrentControlSet\Services\NexomaticRemoteSink\EnvironmentSet the following values (type REG_SZ):
$svcKey = "HKLM:\SYSTEM\CurrentControlSet\Services\NexomaticRemoteSink\Environment"New-Item -Path $svcKey -Force | Out-NullSet-ItemProperty -Path $svcKey -Name HUB_HOST -Value "hub.example.com"Set-ItemProperty -Path $svcKey -Name HUB_PORT -Value "50051"Set-ItemProperty -Path $svcKey -Name HUB_TLS -Value "true"Set-ItemProperty -Path $svcKey -Name CLIENT_ID -Value "<node-client-id>"Set-ItemProperty -Path $svcKey -Name CLIENT_SECRET -Value "<your-secret>"Set-ItemProperty -Path $svcKey -Name AUTH_METHOD -Value "client_credentials"Set-ItemProperty -Path $svcKey -Name ROOT_FOLDER -Value "C:\Program Files\Nexomatic Remote Sink"Set-ItemProperty -Path $svcKey -Name TENANT_ID -Value "<your-tenant-id>"Set-ItemProperty -Path $svcKey -Name UPDATE_BASE_URL -Value "https://releases.example.com/nexomatic-sink"CLIENT_TYPE defaults to REMOTE when unset. The tenant-pinning values (TENANT_UUID, TENANT_SECRET) are optional.
Step 3 — Register and start the service
Section titled “Step 3 — Register and start the service”sc.exe create NexomaticRemoteSink binPath= "C:\Program Files\Nexomatic Remote Sink\sink_service.exe" start= autosc.exe failure NexomaticRemoteSink reset= 60 actions= restart/5000/restart/5000/restart/5000sc.exe failureflag NexomaticRemoteSink 1sc.exe start NexomaticRemoteSinkAutomatic Updates
Section titled “Automatic Updates”When your administrator publishes a new version, the Hub signals the running service to update. The service will:
- Finish any in-progress tasks
- Download the new installer silently
- Apply the update and restart
No manual action is required. The service will be briefly unavailable during the update (typically under 30 seconds).
Managing the Service
Section titled “Managing the Service”# StopStop-Service NexomaticRemoteSink
# StartStart-Service NexomaticRemoteSink
# RestartRestart-Service NexomaticRemoteSink
# View recent log entries (Event Viewer)Get-EventLog -LogName Application -Source NexomaticRemoteSink -Newest 20Uninstalling
Section titled “Uninstalling”Run the uninstaller from Add or Remove Programs, or from PowerShell:
sc.exe stop NexomaticRemoteSinksc.exe delete NexomaticRemoteSinkRemove-Item -Recurse "C:\Program Files\Nexomatic Remote Sink"Troubleshooting
Section titled “Troubleshooting”| Symptom | Likely cause | Fix |
|---|---|---|
| Service fails to start | Missing or wrong credentials | Check registry values with Get-ItemProperty |
Sink shows OFFLINE in UI | Cannot reach Hub | Check firewall — outbound TCP to Hub host:port must be allowed |
| Tasks not running | Credential mismatch | Confirm CLIENT_ID matches the node registered in Nexomatic |
| Update stuck | Installer running silently | Wait 60 seconds; if still stuck, manually restart the service |