Remote Access Beta

Connect to client devices directly from Servelo using RustDesk, an open-source remote desktop tool. Technicians can launch a remote session with one click from any asset page.

How It Works

Servelo's remote access integration uses RustDesk, a free and open-source remote desktop application. Here's the flow:

1. You self-host a RustDesk relay server (hbbs + hbbr) on your own infrastructure.
2. You configure the relay hostname and public key once in Settings → Integrations → RustDesk Remote Access.
3. For each client asset you want to access remotely, you install the RustDesk client on that device, set a permanent password, and save the Peer ID and password on the asset's detail page in Servelo.
4. When you need to connect, open the asset page and click Connect Remotely. Servelo launches the RustDesk client on your machine pre-filled with the Peer ID via the rustdesk:// protocol.
5. Enter the password when prompted and you're in.

Requirements

• Self-hosted RustDesk server: hbbs (ID server) and hbbr (relay server) running on a VPS or dedicated machine with a public IP. See the RustDesk self-host guide.
• RustDesk client installed on technician devices: available for Windows, macOS, Linux, iOS, and Android at rustdesk.com/download.
• RustDesk client installed on each client device: with a permanent password configured on that device.
• Admin role in Servelo: to configure the relay settings.

Setup

Step 1: Set up your RustDesk server

Deploy RustDesk Server on a VPS (Ubuntu/Debian recommended). The two services you need:

• hbbs: ID/rendezvous server, listens on ports 21115, 21116, 21118
• hbbr: relay server, listens on ports 21117, 21119

After first launch, hbbs generates a keypair. Your public key is in id_ed25519.pub in the data directory. You'll need this in Step 2.

Step 2: Configure Servelo

1. Go to Settings → Integrations and click Setup under RustDesk Remote Access.
2. Enter your Relay Server Host (the hostname or IP of your hbbs/hbbr server, e.g. rustdesk.yourdomain.com).
3. Enter your Public Key (the contents of id_ed25519.pub on your hbbs host).
4. Click Save.

Step 3: Configure client devices

1. Install RustDesk on the client's device.
2. In RustDesk settings on that device, point it to your relay server host and enter your public key so it uses your private relay instead of the RustDesk public relay.
3. Set a permanent password on the device (RustDesk → Security → Permanent Password).
4. Note the Peer ID shown in RustDesk on that device.

Step 4: Save credentials on the asset

1. Open the client profile in Servelo, go to their Assets, and open the relevant asset.
2. Scroll to the Remote Access section.
3. Enter the RustDesk Peer ID and RustDesk Password.
4. Save the asset. The Connect Remotely button will now appear, and the asset card will show a green Remote badge.

Connecting Remotely

1. Open the asset in Servelo and click Connect Remotely.
2. Click Open in RustDesk. This launches RustDesk on your machine with the Peer ID pre-filled via the rustdesk:// protocol.
3. Enter the password when prompted.

If RustDesk is not installed on your machine, click Not installed? Download → to get it.

Asset Card Indicator

Assets with a Peer ID configured show a green Remote badge at the bottom of their card in the asset grid. This lets you immediately see which devices are set up for remote access without opening each one.

Current Limitations

• Each tenant must operate their own RustDesk server. There is no shared Servelo-managed relay.
• The rustdesk:// protocol link requires RustDesk to be installed locally on the technician's device.
• Passwords are stored encrypted in Servelo's database. Only admin and technician roles can view the Remote Access section on an asset.
• This feature is in beta. Behavior may change in future releases.