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
rustdesk-1.5.3-x86_64.exe: the client; run it portable or install it from it (technician PC).rustdesk-1.5.3-x86_64.msi: the same client as a Windows installer package (used for servers).README.html: this guide.LICENSE-NOTICE.txt: licence (AGPL-3.0) and link to the source code of this version.Install-RustDeskClient.ps1andRustDeskConfig.psm1: install script and helper module for a customer server (chapter 8); keep both in the same folder.SHA256SUMS.txt: SHA-256 checksums of the files above.
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
- Option 1, portable: double-click
rustdesk-1.5.3-x86_64.exe. Nothing is installed; the client runs until you close it. - Option 2, install: run
rustdesk-1.5.3-x86_64.exeand choose "Install" in the window that appears (administrator rights are requested).
5. Configure the server and key
- In RustDesk open the menu next to your ID, then Settings, then Network, and unlock the network settings (Windows asks for administrator rights).
- 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
- ID server:
- 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.
- 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).
- 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).
- 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>' - 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. - 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.