Instantly share code, notes, and snippets. Star 2 ( 2 ) You must be signed in to star a gist Fork 0 ( 0 ) You must be signed in to fork a gist Embed Select an option Embed Embed this gist in your website. Share Copy sharable link for this gist. Clone via HTTPS Clone using the web URL. No results found Learn more about clone URLs Clone this repository at <script src="https://gist.github.com/michele-tn/3dd7b8c2f4c6a4e3c21fd4b5c7d40a6d.js"></script> Embed Embed this gist in your website. Share Copy sharable link for this gist. Clone via HTTPS Clone using the web URL. No results found Save michele-tn/3dd7b8c2f4c6a4e3c21fd4b5c7d40a6d to your computer and use it in GitHub Desktop. Embed Embed this gist in your website. Share Copy sharable link for this gist. Clone via HTTPS Clone using the web URL. No results found This repository provides a PowerShell script that automatically downloads, configures, and launches the RustDesk Windows x64 portable client , using only your self-hosted ID server and public key . It is ideal for: 🔧 Mass deployment (RMM, GPO, Intune, etc.) 🧰 Technicians who need a ready-to-use portable RustDesk client 💼 Environments where software installation is restricted Note This script configures the client only . It does not install or manage a RustDesk server. For server setup, refer to the official RustDesk documentation . Official PowerShell script (published as a Gist): 🔗 RustDeskPortable.ps1: https://gist.github.com/michele-tn/8a824d6257147718fd8384da0fa13f7a download it as a single .ps1 file, include it in deployment packages, or run it remotely using PowerShell ( Invoke-WebRequest , Invoke-RestMethod , etc.) 🆕 Automatically fetches the latest RustDesk release tag from GitHub. 💾 Downloads the corresponding Windows x64 portable executable. ⚙️ Creates a valid RustDesk configuration file with: rendezvous_server key rendezvous_server 🧱 Uses the official RustDesk config path for the current user: %AppData%\RustDesk\config\RustDesk2.toml 🪶 No installation required — fully portable. 🧾 Logs download and update information. ▶️ Launches RustDesk automatically once configured. Operating System: Windows 10 / 11 (64-bit) Operating System: Windows 10 / 11 (64-bit) PowerShell: Windows PowerShell 5.1+ or PowerShell 7+ Windows PowerShell 5.1+ or Network: Outbound HTTPS access to: api.github.com github.com Network: Outbound HTTPS access to: Server: Self-hosted RustDesk hbbs (ID server) and a valid public key ( id_ed25519.pub ). Server: Self-hosted RustDesk hbbs (ID server) and a valid public key ( id_ed25519.pub ). Script Parameters ServerIP → Address or hostname of your RustDesk ID server (hbbs) Key → The full public key string used by your RustDesk server Generated Configuration Example The script writes this configuration file to: Example contents:

Only ID server and key are configured — no relay or API server entries are set. Detects the script execution directory. Creates a clean portable folder ( RustDeskPortable ) and user config directory. Fetches the latest tag from the official RustDesk GitHub repository. Locates the Windows x64 portable executable (no installer, no server build). Downloads and verifies it. Generates a RustDesk2.toml file with your provided ServerIP and Key . Updates the local update.log with tag and timestamp. Starts RustDesk automatically, ready to connect. 1. Download the Script 2. Run the Script Or as a one-liner for deployment systems (RMM / GPO / Intune): Output Overview After successful execution: ✅ RustDeskPortable\rustdesk.exe downloaded ✅ RustDeskPortable\update.log updated ✅ %AppData%\RustDesk\config\RustDesk2.toml created 🚀 RustDesk automatically launched and ready to use Deployment Scenarios You can automate this for: Group Policy (GPO): Assign as a startup/logon script Group Policy (GPO): Assign as a startup/logon script RMM / MDM / Intune: Deploy remotely with PowerShell scripting RMM / MDM / Intune: Deploy remotely with PowerShell scripting USB Toolkit: Carry and run from a USB drive for field operations USB Toolkit: Carry and run from a USB drive for field operations Troubleshooting Security Recommendations Keep your public/private key pairs secure. Use HTTPS for your RustDesk server. Verify script integrity before deploying. Restrict outbound access to trusted domains only. This script is provided "as-is" , with no warranty. Always test it in a controlled environment before mass deployment. Author: Michele TN (original Gist) xman0980 commented Jan 22, 2026 can you help me figure out this error when i try to run it? michele-tn commented Jan 22, 2026 can you help me figure out this error when i try to run it? Fixed Unicode and Parsing Issues in RustDeskPortable.ps1 The script has been cleaned to remove all non-ASCII/Unicode characters that were causing PowerShell parsing errors such as: xman0980 commented Jan 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page . There was an error while loading. Please reload this page . There was an error while loading. Please reload this page . OMG thanks so much for fixing it. Now I have to figure out how to have CrowdStrike Falcon not block it when trying to run rustdesk.exe. Thanks corporate IT! LOL michele-tn commented Jan 23, 2026 OMG thanks so much for fixing it. Now I have to figure out how to have CrowdStrike Falcon not block it when trying to run rustdesk.exe. Thanks corporate IT! LOL I get the frustration 😄 That said, remote administration tools like RustDesk are powerful software and fall into some of the most sensitive categories from a security standpoint. It’s therefore normal for EDR solutions like CrowdStrike to block them by default in corporate environments. It’s not about “blocking things for no reason”, but about reducing risk: if these tools are genuinely needed, they should be properly reviewed, approved, and whitelisted according to company policies. Cyber Security in the enterprise is not optional! ;-)