Home › Self-host the relay
Your own server · no third-party cloud

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

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).

Recommended · Windows

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.32.8)
Requires administrator rights · approx. 55 MB
Windows · manual

Windows package (ZIP)

No installer: unzip and run install-relay.ps1 as administrator. For anyone who prefers to set up the service with PowerShell.

Download ZIP
Contains the same server build · approx. 47 MB
Linux · Docker

Linux package (source)

Turnkey with Docker: unpack and run sudo bash install.sh. Optionally with Caddy and an automatic HTTPS certificate.

Linux package (tar.gz)
Builds the Docker image from source · approx. 100 KB

Windows in three steps

  1. Run the MSI. Double-click, confirm the port you want (default 9770) and leave the key empty – it’s generated automatically.
  2. Note down the key. After installation, you’ll find it in C:\ProgramData\RemoteCircle Relay\data\relay-key.txt.
  3. 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 until 31 December 2027 for the launch, businesses included. The licence key for several simultaneous sessions is free by email – using either the ready-made relay from MARIOSIEBERT-IT or your own server.