RustDesk client 1.5.3: setup guide

1. What this is

RustDesk is an open-source remote desktop program. This package contains the official Windows (x64) client, version 1.5.3, unmodified, so that a controlling PC can connect to the self-hosted RustDesk server rustdesk.alexpuh.de that is used for remote maintenance.

2. Package contents

The package contains no key. The server key is handed to you separately by the provider; never send it by e-mail together with this package, and never store it in shared folders.

3. Verify the download

Compare the checksum of the zip with the value on the download page, and the extracted files with SHA256SUMS.txt (PowerShell):

Get-FileHash .\rustdesk-1.5.3-x86_64.exe -Algorithm SHA256
Get-FileHash .\rustdesk-1.5.3-x86_64.msi -Algorithm SHA256

The values must be identical to those in SHA256SUMS.txt.

4. Start the client

5. Configure the server and key

  1. In RustDesk open the menu next to your ID, then Settings, then Network, and unlock the network settings (Windows asks for administrator rights).
  2. Open ID/Relay server and enter:
    • ID server: rustdesk.alexpuh.de
    • Relay server: empty (the server announces it)
    • API server: empty
    • Key: the value you received separately from the provider
  3. Confirm with OK. The status line at the bottom of the main window shows "Ready" when the server is reachable.

Without the key, or with a wrong key, the client shows "key mismatch" and cannot use the server.

6. The server runs on demand

The server is switched on only for maintenance sessions. Connections work only while the provider has started it; ask the provider to start it before you connect. If the status line says the service is not ready, the server is probably not started.

7. Test connection

Configure two machines (A and B) as above. Note the ID shown on machine B, enter it on machine A and click Connect, enter the one-time password of B (or accept the request on B), and confirm that A shows the screen of B.

8. Installing on a customer server

The client runs on a customer server as an unattended Windows service. The install script takes the MSI from this package; nothing is downloaded. Do this for one server at a time, in a remote session (for example TeamViewer) that stays open until the check at the end.

  1. On the server, download the zip from the download page, compare its SHA-256 with the value shown on the page, and extract it to a new folder (for example on the desktop).
  2. Get the server's public key from the provider (separately from this package) and have the unattended password ready (it is chosen by the provider and kept in the password manager).
  3. Open Windows PowerShell as Administrator, change to the extracted folder and run (replace the placeholder with the key):
    Get-ChildItem . | Unblock-File
    powershell -NoProfile -ExecutionPolicy Bypass -File .\Install-RustDeskClient.ps1 -PublicKey '<public-key>'
  4. The script checks the MSI against SHA256SUMS.txt (a mismatch stops it before anything is installed), installs the client, applies the server settings, asks twice for the unattended password and prints the RustDesk ID. Note the ID in the password manager.
  5. Check from the controlling client: connect with the ID and the password, at the login screen and with a logged-on session; a wrong password must be rejected. The server must be started by the provider first.

To update later, run the script of the newer package with -SkipPassword; password and settings are kept. Never put the password into a file or a chat message.

RustDesk is licensed under AGPL-3.0; see LICENSE-NOTICE.txt.