Helmo Middleware won't connect

If the Helmo Middleware desktop app won't connect to your workspace, follow these steps.

1. Verify the API key

The most common issue is an incorrect or expired API key.

• Go to Connect > Middleware in your workspace.
• Generate a new API key if needed.
• Copy it carefully and paste it into the Helmo Middleware app.

2. Check your network

Helmo Middleware needs outbound internet access to reach Helmo's servers.

• Make sure the machine has an active internet connection.
• Check if a firewall or proxy is blocking WebSocket connections.
• Helmo Middleware uses secure WebSocket connections, which typically run on port 443.

3. Restart Helmo Middleware

• Close Helmo Middleware from the system tray.
• Reopen it.
• The app should automatically attempt to reconnect using the stored API key.

4. Check the version

• Outdated versions may have compatibility issues.
• Helmo Middleware checks for updates automatically. If prompted, install the latest version.

5. Check the Middleware tab

In Connect, go to the Middleware tab:

• If it appears but shows Offline, it registered previously but lost connection.
• If it doesn't appear at all, the API key may be invalid or the registration failed.

6. Firewall rules

Make sure these are not blocked:

• Outbound HTTPS (port 443) to Helmo's servers.
• WebSocket connections to the same domain.

If your organization has strict firewall rules, ask your IT team to whitelist the required endpoints.