RemoteCircle logo RemoteCircle
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.25.0)
Requires administrator rights · approx. 54 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. 46 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 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.