Skip to content
deadboy18 edited this page Aug 16, 2024 · 2 revisions

Welcome to the clientdeploy wiki!

RustReady.ps1

Overview

RustReady.ps1 is a PowerShell script designed to automate tasks for RustDesk deployment, simplifying the setup and configuration process. The script is customizable to suit the needs of different organizations.

Prerequisites

  • Operating System: Windows 10/11
  • PowerShell Version: PowerShell 5.1 or later is recommended.
  • Administrator Privileges: Required to run the script.

Installation and Setup

1. Download the Script

  1. Download RustReady.ps1 to your local machine.
  2. Save it to a preferred directory.

2. Running the Script

  1. Right-click on the RustReady.ps1 file.
  2. Select Run with PowerShell from the context menu.

The script includes an automatic unblocking feature to bypass Windows security settings that may block files downloaded from the internet. The following lines are included at the beginning of the script:

$scriptPath = $MyInvocation.MyCommand.Path
Unblock-File -Path $scriptPath

This ensures the script is unblocked automatically upon execution.

Customization

You can modify several aspects of the script to match your organization's requirements:

1. Environment Variables

  • Default Paths: Adjust default paths to fit your environment.

    $DefaultConfigPath = "C:\YourCustomPath\Config"

2. Network Settings

  • Proxy Configuration: Set your organization's proxy if necessary.

    $ProxyServer = "proxy.yourorganization.com"

3. Service Configuration

  • Service Accounts and Ports: Modify service accounts and ports as needed.

    $RustDeskServicePort = 443

4. TOML File Customizations

  • Client Theme and Settings: Edit the RustDesk_local.toml file for client settings.

  • Server Configurations: Modify the RustDesk2.toml file for server-specific configurations.

    [server]
    server_address = "yourserver.com"
    port = 21115

For more information on advanced RustDesk client settings, refer to the RustDesk Client Advanced Settings Documentation.

5. Additional Scripts

  • Custom Commands: Insert additional scripts or commands as needed.

    & "C:\Scripts\YourCustomScript.ps1"

Troubleshooting

Script Fails to Run

If the script fails to run due to security settings or other issues:

  • Manual Unblocking: In some cases, manual unblocking may still be required. Right-click the script file, select Properties, and check Unblock under the General tab. 1 2 GIF_UNBLOCK

  • Administrator Permissions: Ensure that you are running the script with elevated privileges.

Contributions and Future Improvements

We are actively working on improving the RustReady.ps1 script. Contributions are welcome! If you have suggestions, feel free to join and contribute to the project.