doc.rustdesk.com/content/self-host/Client Deployment/_index.en.md

314 lines
9.4 KiB
Markdown
Raw Normal View History

2023-08-21 21:46:01 +02:00
---
title: Client Deployment
2023-08-29 05:42:52 +02:00
weight: 400
pre: "<b>2.4. </b>"
2023-08-21 21:46:01 +02:00
---
2023-08-23 09:37:55 +02:00
You can deploy using a number of methods, some are covered in [Client](/docs/en/client/#configuring-rustdesk)
2023-08-21 21:46:01 +02:00
2023-08-27 20:43:15 +02:00
Alternatively you can use mass deployment scripts with your RMM, Intune etc., the ID and password is output by the script, you should collect this, or split this off into different scripts to collect the ID and password.
2023-08-21 21:46:01 +02:00
2023-08-28 23:07:09 +02:00
The permanent password can be changed from random to one you prefer using by changing the content inside `()` after `rustdesk_pw` to your preferred password for powershell and the corresponding line for any other platform.
2023-08-24 17:56:01 +02:00
2023-08-27 20:43:15 +02:00
### PowerShell
2023-08-21 21:46:01 +02:00
```ps
$ErrorActionPreference= 'silentlycontinue'
2023-08-24 18:11:12 +02:00
# Assign the value random password to the password variable
2023-08-28 23:07:09 +02:00
$rustdesk_pw=(-join ((65..90) + (97..122) | Get-Random -Count 12 | % {[char]$_}))
2023-08-24 17:56:01 +02:00
2023-08-27 20:43:15 +02:00
# Get your config string from your Web portal and Fill Below
2023-08-24 18:11:12 +02:00
rustdesk_cfg="configstring"
2023-08-24 17:56:01 +02:00
2023-08-27 20:43:15 +02:00
################################### Please Do Not Edit Below This Line #########################################
2023-08-24 17:56:01 +02:00
2023-08-27 20:43:15 +02:00
# Run as administrator and stays in the current directory
2023-08-24 18:11:12 +02:00
if (-Not ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)) {
if ([int](Get-CimInstance -Class Win32_OperatingSystem | Select-Object -ExpandProperty BuildNumber) -ge 6000) {
Start-Process PowerShell -Verb RunAs -ArgumentList "-NoProfile -ExecutionPolicy Bypass -Command `"cd '$pwd'; & '$PSCommandPath';`"";
Exit;
}
}
2023-08-24 17:56:01 +02:00
$rdver = ((Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\RustDesk\").Version)
2023-08-21 21:46:01 +02:00
2023-08-21 21:56:14 +02:00
if($rdver -eq "1.2.2")
2023-08-21 21:46:01 +02:00
{
write-output "RustDesk $rdver is the newest version"
exit
}
If (!(Test-Path c:\Temp)) {
New-Item -ItemType Directory -Force -Path c:\Temp > null
}
cd c:\Temp
2023-08-24 14:40:15 +02:00
powershell Invoke-WebRequest "https://github.com/rustdesk/rustdesk/releases/download/1.2.2/rustdesk-1.2.2-x86_64.exe" -Outfile "rustdesk.exe"
2023-08-21 21:46:01 +02:00
Start-Process .\rustdesk.exe --silent-install -wait
$ServiceName = 'Rustdesk'
$arrService = Get-Service -Name $ServiceName -ErrorAction SilentlyContinue
if ($arrService -eq $null)
{
Start-Sleep -seconds 20
}
while ($arrService.Status -ne 'Running')
{
Start-Service $ServiceName
Start-Sleep -seconds 5
$arrService.Refresh()
}
2023-08-24 14:40:15 +02:00
2023-08-24 15:32:22 +02:00
cd $env:ProgramFiles\RustDesk\
$rustdesk_id = (.\RustDesk.exe --get-id | out-host)
net stop rustdesk > null
2023-08-24 18:11:12 +02:00
.\RustDesk.exe --config $rustdesk_cfg
2023-08-24 15:32:22 +02:00
$ProcessActive = Get-Process rustdesk -ErrorAction SilentlyContinue
if($ProcessActive -ne $null)
{
stop-process -ProcessName rustdesk -Force
}
Start-Process "$env:ProgramFiles\RustDesk\RustDesk.exe" "--password $rustdesk_pw" -wait
2023-08-24 18:11:12 +02:00
Write-Output "..............................................."
# Show the value of the ID Variable
Write-Output "RustDesk ID: $rustdesk_id"
# Show the value of the Password Variable
Write-Output "Password: $rustdesk_pw"
Write-Output "..............................................."
2023-08-21 21:46:01 +02:00
```
2023-08-28 23:02:51 +02:00
### Windows batch/cmd
```bat
REM Assign the value random password to the password variable
set rustdesk_pw=
REM Get your config string from your Web portal and Fill Below
set rustdesk_cfg="configstring"
REM ############################### Please Do Not Edit Below This Line #########################################
if not exist C:\TEMP\ md C:\TEMP\
cd c:\temp\
curl -L "https://github.com/rustdesk/rustdesk/releases/download/1.2.2/rustdesk-1.2.2-x86_64.exe" -o rustdesk.exe
rustdesk.exe --silent-install
$ServiceName = 'Rustdesk'
$arrService = Get-Service -Name $ServiceName -ErrorAction SilentlyContinue
cd "c:\Program Files\RustDesk\"
for /f "delims=" %i IN ('rustdesk.exe --get-id ^| more') DO set rustdesk_id=%i
net stop rustdesk > null
RustDesk.exe --config %rustdesk_cfg%
net start rustdesk > null
RustDesk.exe --password %rustdesk_pw%
echo "..............................................."
REM Show the value of the ID Variable
echo "RustDesk ID: %rustdesk_id%"
REM Show the value of the Password Variable
echo "Password: %rustdesk_pw%"
echo "..............................................."
```
2023-08-24 18:11:12 +02:00
2023-08-27 20:43:15 +02:00
### macOS Bash
2023-08-21 21:46:01 +02:00
```sh
#!/bin/bash
2023-08-24 14:40:15 +02:00
# Assign the value random password to the password variable
2023-08-24 18:11:12 +02:00
rustdesk_pw=$(openssl rand -hex 4)
2023-08-21 21:46:01 +02:00
2023-08-27 20:43:15 +02:00
# Get your config string from your Web portal and Fill Below
2023-08-24 18:11:12 +02:00
rustdesk_cfg="configstring"
2023-08-21 21:46:01 +02:00
2023-08-27 20:43:15 +02:00
################################### Please Do Not Edit Below This Line #########################################
2023-08-21 21:46:01 +02:00
# Check if the script is being run as root
if [[ $EUID -ne 0 ]]; then
echo "This script must be run as root."
exit 1
fi
# Specify the path to the rustdesk.dmg file
dmg_file="/tmp/rustdesk-1.2.2-x86_64.dmg"
# Specify the mount point for the DMG (temporary directory)
mount_point="/Volumes/RustDesk"
# Download the rustdesk.dmg file
echo "Downloading RustDesk Now"
2023-08-24 14:40:15 +02:00
if [[ $(arch) == 'arm64' ]]; then
curl -L https://github.com/rustdesk/rustdesk/releases/download/1.2.2/rustdesk-1.2.2-aarch64.dmg --output "$dmg_file"
else
2023-08-21 21:56:14 +02:00
curl -L https://github.com/rustdesk/rustdesk/releases/download/1.2.2/rustdesk-1.2.2-x86_64.dmg --output "$dmg_file"
2023-08-24 14:40:15 +02:00
fi
2023-08-21 21:46:01 +02:00
# Mount the DMG file to the specified mount point
hdiutil attach "$dmg_file" -mountpoint "$mount_point" &> /dev/null
# Check if the mounting was successful
if [ $? -eq 0 ]; then
# Move the contents of the mounted DMG to the /Applications folder
cp -R "$mount_point/RustDesk.app" "/Applications/" &> /dev/null
# Unmount the DMG file
hdiutil detach "$mount_point" &> /dev/null
else
echo "Failed to mount the RustDesk DMG. Installation aborted."
exit 1
fi
# Run the rustdesk command with --get-id and store the output in the rustdesk_id variable
cd /Applications/RustDesk.app/Contents/MacOS/
rustdesk_id=$(./RustDesk --get-id)
# Apply new password to RustDesk
./RustDesk --server &
2023-08-24 18:11:12 +02:00
/Applications/RustDesk.app/Contents/MacOS/RustDesk --password $rustdesk_pw &> /dev/null
2023-08-21 21:46:01 +02:00
2023-08-24 18:11:12 +02:00
/Applications/RustDesk.app/Contents/MacOS/RustDesk --config $rustdesk_cfg
2023-08-21 21:46:01 +02:00
# Kill all processes named RustDesk
rdpid=$(pgrep RustDesk)
kill $rdpid &> /dev/null
echo "..............................................."
# Check if the rustdesk_id is not empty
if [ -n "$rustdesk_id" ]; then
echo "RustDesk ID: $rustdesk_id"
else
echo "Failed to get RustDesk ID."
fi
# Echo the value of the password variable
2023-08-24 18:11:12 +02:00
echo "Password: $rustdesk_pw"
2023-08-21 21:46:01 +02:00
echo "..............................................."
echo "Please complete install on GUI, launching RustDesk now."
open -n /Applications/RustDesk.app
```
### Linux
```sh
#!/bin/bash
2023-08-24 15:03:22 +02:00
# Assign a random value to the password variable
2023-08-24 18:11:12 +02:00
rustdesk_pw=$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 8 | head -n 1)
2023-08-24 15:03:22 +02:00
2023-08-27 20:43:15 +02:00
# Get your config string from your Web portal and Fill Below
2023-08-28 23:07:09 +02:00
rustdesk_cfg="configstring"
2023-08-21 21:46:01 +02:00
2023-08-27 20:43:15 +02:00
################################### Please Do Not Edit Below This Line #########################################
2023-08-21 21:46:01 +02:00
# Check if the script is being run as root
if [[ $EUID -ne 0 ]]; then
echo "This script must be run as root."
exit 1
fi
2023-08-27 20:43:15 +02:00
# Identify OS
2023-08-21 21:46:01 +02:00
if [ -f /etc/os-release ]; then
# freedesktop.org and systemd
. /etc/os-release
OS=$NAME
VER=$VERSION_ID
UPSTREAM_ID=${ID_LIKE,,}
# Fallback to ID_LIKE if ID was not 'ubuntu' or 'debian'
if [ "${UPSTREAM_ID}" != "debian" ] && [ "${UPSTREAM_ID}" != "ubuntu" ]; then
UPSTREAM_ID="$(echo ${ID_LIKE,,} | sed s/\"//g | cut -d' ' -f1)"
fi
elif type lsb_release >/dev/null 2>&1; then
# linuxbase.org
OS=$(lsb_release -si)
VER=$(lsb_release -sr)
elif [ -f /etc/lsb-release ]; then
# For some versions of Debian/Ubuntu without lsb_release command
. /etc/lsb-release
OS=$DISTRIB_ID
VER=$DISTRIB_RELEASE
elif [ -f /etc/debian_version ]; then
2023-08-27 20:43:15 +02:00
# Older Debian, Ubuntu, etc.
2023-08-21 21:46:01 +02:00
OS=Debian
VER=$(cat /etc/debian_version)
2023-08-27 20:43:15 +02:00
elif [ -f /etc/SuSE-release ]; then
# Older SuSE etc.
2023-08-21 21:46:01 +02:00
OS=SuSE
2023-08-27 20:43:15 +02:00
VER=$(cat /etc/SuSE-release)
2023-08-21 21:46:01 +02:00
elif [ -f /etc/redhat-release ]; then
# Older Red Hat, CentOS, etc.
OS=RedHat
VER=$(cat /etc/redhat-release)
else
# Fall back to uname, e.g. "Linux <version>", also works for BSD, etc.
OS=$(uname -s)
VER=$(uname -r)
fi
2023-08-27 20:43:15 +02:00
# Install RustDesk
2023-08-21 21:46:01 +02:00
2023-08-27 20:43:15 +02:00
echo "Installing RustDesk"
2023-08-21 21:46:01 +02:00
if [ "${ID}" = "debian" ] || [ "$OS" = "Ubuntu" ] || [ "$OS" = "Debian" ] || [ "${UPSTREAM_ID}" = "ubuntu" ] || [ "${UPSTREAM_ID}" = "debian" ]; then
2023-08-21 21:56:14 +02:00
wget https://github.com/rustdesk/rustdesk/releases/download/1.2.2/rustdesk-1.2.2-x86_64.deb
2023-08-21 21:46:01 +02:00
apt-get install -fy ./rustdesk-1.2.2-x86_64.deb > null
elif [ "$OS" = "CentOS" ] || [ "$OS" = "RedHat" ] || [ "$OS" = "Fedora Linux" ] || [ "${UPSTREAM_ID}" = "rhel" ] ; then
2023-08-21 21:56:14 +02:00
wget https://github.com/rustdesk/rustdesk/releases/download/1.2.2/rustdesk-1.2.2-0.x86_64.rpm
2023-08-21 21:46:01 +02:00
yum localinstall ./rustdesk-1.2.2-0.x86_64.rpm -y > null
else
echo "Unsupported OS"
# here you could ask the user for permission to try and install anyway
# if they say yes, then do the install
# if they say no, exit the script
exit 1
fi
systemctl stop rustdesk
# Run the rustdesk command with --get-id and store the output in the rustdesk_id variable
rustdesk_id=$(rustdesk --get-id)
# Apply new password to RustDesk
systemctl start rustdesk
2023-08-24 18:11:12 +02:00
rustdesk --password $rustdesk_pw &> /dev/null
2023-08-21 21:46:01 +02:00
2023-08-24 18:11:12 +02:00
rustdesk --config $rustdesk_cfg
2023-08-21 21:46:01 +02:00
systemctl restart rustdesk
echo "..............................................."
# Check if the rustdesk_id is not empty
if [ -n "$rustdesk_id" ]; then
echo "RustDesk ID: $rustdesk_id"
else
echo "Failed to get RustDesk ID."
fi
# Echo the value of the password variable
echo "Password: $rustdesk_password"
echo "..............................................."
```