RustDesk Native Client Setup
Beacon’s Tier 2 remote access (full graphical remote desktop) uses RustDesk as the client-side application. This article covers installing and configuring the RustDesk native client on both technician workstations and managed endpoints.
For an overview of all three remote access tiers and how the relay works, see Connecting via RustDesk.
Installing RustDesk on technician machines
Download the RustDesk client for your platform from rustdesk.com/download or the GitHub releases page.
| Platform | Installer |
|---|---|
| Windows | rustdesk-windows-x86_64.exe |
| macOS (Intel) | rustdesk-macos-x86_64.dmg |
| macOS (Apple Silicon) | rustdesk-macos-aarch64.dmg |
| Linux (Debian/Ubuntu) | rustdesk-linux-x86_64.deb |
| Linux (RPM) | rustdesk-linux-x86_64.rpm |
No special configuration is needed on the technician’s RustDesk client — Beacon passes the relay server details at connection time via a one-time connection credential.
Deploying RustDesk to managed endpoints
RustDesk must be installed on managed endpoints before Tier 2 sessions can be initiated. Use a Beacon Job to deploy it:
Windows — PowerShell deployment component
$version = "1.3.9" # Pin to a tested version; update periodically
$url = "https://github.com/rustdesk/rustdesk/releases/download/$version/rustdesk-$version-x86_64.exe"
$installer = "$env:TEMP\rustdesk-install.exe"
Invoke-WebRequest -Uri $url -OutFile $installer -UseBasicParsing
Start-Process $installer -ArgumentList "--silent-install" -Wait
Remove-Item $installer
Write-Output "RustDesk $version installed"
Linux — bash deployment component
VERSION="1.3.9"
ARCH="x86_64"
URL="https://github.com/rustdesk/rustdesk/releases/download/${VERSION}/rustdesk-${VERSION}-${ARCH}.deb"
DEB="/tmp/rustdesk.deb"
curl -sL "$URL" -o "$DEB"
dpkg -i "$DEB" && rm "$DEB"
systemctl enable --now rustdesk
echo "RustDesk ${VERSION} installed"
Create these as Components in the Components library, then run them as a Job targeting all devices (or a specific company) during a maintenance window.
Verifying RustDesk is running on endpoints
After deployment, check the RustDesk service status:
# Windows
Get-Service RustDesk | Select-Object Name, Status
# Linux
systemctl status rustdesk
A device ready for Tier 2 sessions will show RustDesk as Running in the system services.
Pinning RustDesk versions
Beacon does not manage RustDesk versions directly. To maintain a consistent version across your fleet:
- Create a Component that checks the installed RustDesk version and outputs the version string
- Run it as a quick Job across all devices
- Compare results in the job output to identify devices running older versions
- Deploy the updated installer to outdated devices
See also: Connecting via RustDesk, Native RDP Tunneling