Self-host the relay server
The relay is the server that brokers access over the internet: the remote PC and the Console both connect to it, and it links the two – with no port forwarding needed at the customer’s site. Run it on your own server: on Windows with an installer, or on Linux with Docker.
Do I need a relay?
Not on the local network: there, the Console connects directly to the Host. You only need the relay once you want to reach customer PCs over the internet. You can use the ready-made relay from MARIOSIEBERT-IT (already preconfigured in the Console and the Host) – or run your own if you want the entire data path in your own hands.
Download the relay
All packages are free. The server needs at least Windows Server 2016 / Windows 10, or a Linux server with Docker (.NET 10).
Windows installer (MSI)
Double-click, choose a port, done. Sets up the “RemoteCircleRelay” service, opens the firewall and automatically generates an access key on first start. Also adds a management window – with a status display and buttons to start, stop and restart the service.
Download MSI (1.25.0)Windows package (ZIP)
No installer: unzip and run install-relay.ps1 as administrator. For anyone who prefers to set up the service with PowerShell.
Linux package (source)
Turnkey with Docker: unpack and run sudo bash install.sh. Optionally with Caddy and an automatic HTTPS certificate.
Windows in three steps
- Run the MSI. Double-click, confirm the port you want (default 9770) and leave the key empty – it’s generated automatically.
- Note down the key. After installation, you’ll find it in
C:\ProgramData\RemoteCircle Relay\data\relay-key.txt. - Enter it in the Console and Host. Use the same address and key everywhere. Done.
Turnkey on Linux
On a server with Docker, a single command does it. If you enter a domain, the script sets up Caddy with an automatic Let’s Encrypt certificate.
tar -xzf RemoteCircle-Relay-Deploy.tar.gz -C /opt/remotecircle cd /opt/remotecircle/deploy/relay sudo bash install.sh
LAN only or over the internet?
LAN only
Enter ws://server-ip:9770 in the Console and Host and forward the port to the server. Simple, but unencrypted – only use it on a trusted network.
Over the internet (recommended)
Put a reverse proxy with TLS in front of it (e.g. Caddy) and use wss://your-domain.com. That way, the screen, keyboard input and the access password are encrypted. Instructions are included with every package.
A note on security: the relay brokers the session and – like any relay server – sees the data stream in the process. Your device list and account settings are end-to-end encrypted regardless. So always use TLS over the internet.
Remote support that documents itself.
Free for personal use and small businesses with one remote session at a time. More remote support channels on request – using either the ready-made relay from MARIOSIEBERT-IT or your own server.