doc.rustdesk.com/content/self-host/rustdesk-server-pro/FAQ/_index.en.md

156 lines
7.6 KiB
Markdown
Raw Normal View History

2023-07-16 00:33:20 +02:00
---
title: FAQ
2023-07-16 05:13:13 +02:00
weight: 600
2023-07-16 00:33:20 +02:00
---
2023-10-10 21:46:33 +02:00
### How can I install with the Simple Install Script?
2023-10-21 21:56:52 +02:00
1. Get your license from [https://rustdesk.com/pricing.html](https://rustdesk.com/pricing.html), check [license](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/license/) page for more details.
2023-07-16 18:55:01 +02:00
2. Spin up a VPS, bare metal or Linux VM.
3. If you want to use DNS and SSL create a DNS name i.e. `rustdesk.yourdomain.com`.
2023-08-23 08:34:19 +02:00
4. Go to [this page](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/installscript/#install).
2023-07-16 18:55:01 +02:00
5. Copy and paste the command into your Linux terminal.
2023-07-16 00:33:20 +02:00
6. Follow the prompts as they guide you through the install.
7. Once the install is complete go to `https://rustdesk.yourdomain.com` or `http://youripaddress:21114`.
8. Log in with the username `admin` and password `test1234`.
9. Enter your license code purchased in step 1.
2023-10-10 21:46:33 +02:00
### How can I convert from RustDesk Server Open Source to RustDesk Server Pro?
2023-10-21 21:56:52 +02:00
1. Get your license from [https://rustdesk.com/pricing.html](https://rustdesk.com/pricing.html), check [license](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/license/) page for more details.
2023-07-16 18:55:01 +02:00
2. Open TCP port 21114.
2023-07-16 00:33:20 +02:00
3. Log into your RustDesk Server.
2023-07-17 12:21:04 +02:00
4. If you didn't already use DNS and want to use SSL create a DNS name i.e. `rustdesk.yourdomain.com`.
2023-08-23 08:34:19 +02:00
5. Go to [this page](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/installscript/#convert-from-open-source).
2023-07-16 18:55:01 +02:00
6. Copy and paste the command into your Linux terminal.
2023-07-16 00:33:20 +02:00
7. Follow the prompts as they guide you through the install.
8. Once the install is complete go to `https://rustdesk.yourdomain.com` or `http://youripaddress:21114`.
9. Log in with the username `admin` and password `test1234`.
10. Enter your license code purchased in step 1.
2023-10-10 21:46:33 +02:00
### There is a new version of RustDesk Server Pro out, how can I upgrade?
2023-08-23 08:34:19 +02:00
1. Go to [this page](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/installscript/#upgrade).
2023-07-16 18:55:01 +02:00
2. Copy and paste the command into your Linux terminal.
2023-07-16 05:21:37 +02:00
3. Follow the prompts as they guide you through the upgrade.
2023-07-16 00:33:20 +02:00
2023-10-10 21:46:33 +02:00
### I installed with the script, how can I start and stop services?
2023-07-16 18:55:01 +02:00
The services use systemd so can be started and stopped using `sudo systemctl stop|start|restart rustdesk-hbbs|rustdesk-hbbr` e.g. `sudo systemctl restart rustdesk-hbbs`.
2023-07-16 00:33:20 +02:00
2023-10-10 21:46:33 +02:00
### I installed with the script, how can I view the Linux logs?
2023-10-23 22:08:29 +02:00
The logs are stored in `/var/log/rustdesk-server`, you can view them using `tail /var/log/rustdesk-server/hbbs.log` or `tail /var/log/rustdesk-server/hbbs.error`.
2023-07-16 00:33:20 +02:00
2023-10-10 21:46:33 +02:00
### I installed with the script, how can I check the status of the RustDesk services?
2023-07-16 18:55:01 +02:00
To check the status `sudo systemctl status rustdesk-hbbs|rustdesk-hbbr` e.g. `sudo systemctl status rustdesk-hbbs`.
2023-07-16 00:33:20 +02:00
2023-10-10 21:46:33 +02:00
### How can I change the admin password?
2023-07-16 00:33:20 +02:00
1. Go to `https://rustdesk.yourdomain.com` or `http://youripaddress:21114`.
2. Log in with the username `admin` and password `test1234`.
3. Click on `admin` in the top right hand corner.
4. Click on `Settings`.
5. Enter your new password in the boxes provided.
2023-10-10 21:46:33 +02:00
### How can I move my license to a new server?
2023-08-23 08:34:19 +02:00
Please see [here](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/license/#invoices-and-migration).
2023-07-16 00:33:20 +02:00
2023-10-10 21:46:33 +02:00
### Emails aren't working from my VPS
2023-07-17 12:21:04 +02:00
A lot of VPS providers block ports 465 and 25.
2023-07-16 19:21:37 +02:00
2023-07-17 12:21:04 +02:00
A simple way to check is using telnet. To test in the Linux terminal type `telnet your.mailserver.com 25`. On Windows use PowerShell with `Test-NetConnection -ComputerName your.mailserver.com -Port 25`.
2023-07-16 19:21:37 +02:00
2023-07-17 12:21:04 +02:00
Your mail server may not be using port 25. Please make sure you are using the correct ports.
2023-07-16 19:21:37 +02:00
2023-10-10 21:46:33 +02:00
### Can I deploy RustDesk using PowerShell or similar?
2023-10-01 13:57:32 +02:00
Sure, you can find scripts to aid deployment [here](https://rustdesk.com/docs/en/self-host/client-deployment/).
2023-07-16 19:21:37 +02:00
2023-10-10 21:46:33 +02:00
### I have installed RustDesk Server Pro manually but the API web console isn't behind SSL, how can I secure this?
2023-07-17 12:21:04 +02:00
Use a proxy like Nginx, the simple install script has one, it's really simple. [This is how we do it](https://github.com/rustdesk/rustdesk-server-pro/blob/493ad90daf8815c3052ff4d0d4aa9cc07e411efa/install.sh#L252).
2023-07-16 19:21:37 +02:00
2023-07-17 12:21:04 +02:00
Similar configs should work with Traefik v2, HAProxy, Apache Proxy and Cloudflare Tunnel.
2023-07-16 19:21:37 +02:00
2023-10-10 21:46:33 +02:00
### How can I file a bug report?
2023-07-16 19:24:03 +02:00
Please file via [GitHub](https://github.com/rustdesk/rustdesk-server-pro/issues).
2023-07-16 19:29:30 +02:00
2023-10-10 21:46:33 +02:00
### Why if I am self hosting is this not free and open source?
2023-07-16 19:54:18 +02:00
1. RustDesk has become a full time job for a number of people, they have lives, wives, jobs and kids which all demands attention and costs money!
2023-07-16 22:31:01 +02:00
2. We want to be here and still making great progress in years to come.
2023-07-17 12:21:04 +02:00
3. The open source version will continue to be open source and we encourage others to make developments in line with the AGPL license.
2023-07-16 19:54:18 +02:00
2023-10-10 21:46:33 +02:00
### I can't connect to devices in different groups, why is this?
2023-07-17 16:49:10 +02:00
This is easily sorted, you need to allow cross-group access.
2023-08-27 21:03:39 +02:00
1. Add new groups.
2. Click `Edit`.
2023-07-17 16:49:10 +02:00
3. Select the relevant groups you want access (it automatically adds them in the corresponding group).
2023-10-10 21:46:33 +02:00
### How can I get configs automatically?
2023-07-17 16:49:10 +02:00
Configs are generated automatically.
2023-07-18 05:52:42 +02:00
1. Download the newest clients from [GitHub](https://github.com/rustdesk/rustdesk/releases/latest).
2023-08-27 21:03:39 +02:00
2. On the main page in the web console click on `Windows EXE`.
2023-07-17 16:49:10 +02:00
3. Fill in the host and API (if different from your config).
2023-08-27 21:03:39 +02:00
4. Click `Submit`.
5. Scan QR Code on Android and rename exe to what has been generated.
2023-07-17 16:49:10 +02:00
2023-10-10 21:46:33 +02:00
### Do you offer hosting for RustDesk Server Pro?
2023-07-16 19:54:18 +02:00
Please get in touch with our [sales](mailto://sales@rustdesk.com) team.
2023-07-16 20:00:45 +02:00
2023-10-10 21:46:33 +02:00
### Is there somewhere I can see video setup guides?
2023-07-17 12:21:04 +02:00
Yes! We have a [YouTube Channel](https://youtube.com/@RustDesk).
2023-08-21 21:46:01 +02:00
2023-10-10 21:46:33 +02:00
### Why are my logs are empty?
2023-08-21 21:46:01 +02:00
Ensure API is set on both the device being controlled and the machine controlling.
On the left hand side click on `Logs`.
2023-08-21 21:53:06 +02:00
2023-10-10 21:46:33 +02:00
### How can I uninstall RustDesk Server Pro?
2023-08-27 21:03:39 +02:00
Run the following commands:
```sh
2023-08-21 21:53:06 +02:00
sudo systemctl stop rustdesk-hbbs.service
sudo systemctl disable rustdesk-hbbs.service
sudo systemctl stop rustdesk-hbbr.service
sudo systemctl disable rustdesk-hbbr.service
sudo systemctl daemon-reload
sudo rm /etc/systemd/system/rustdesk-hbbs.service
sudo rm etc/systemd/system/rustdesk-hbbr.service
sudo rm /usr/bin/hbbs
sudo rm /usr/bin/hbbr
sudo rm -rf /var/lib/rustdesk-server/
sudo rm -rf /var/log/rustdesk-server/
```
2023-08-27 21:03:39 +02:00
If the script installed Nginx then remove using:
```sh
2023-08-21 21:53:06 +02:00
sudo apt remove nginx
```
2023-08-28 23:00:56 +02:00
2023-10-10 21:46:33 +02:00
### How can I remove devices from the device list in the web console?
2023-08-28 23:00:56 +02:00
Disable and then delete will now be available.
2023-10-10 21:46:33 +02:00
### How can I update RustDesk with PowerShell?
2023-08-28 23:00:56 +02:00
```ps
$ErrorActionPreference= 'silentlycontinue'
$rdver = ((Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\RustDesk\").Version)
2023-10-23 22:08:29 +02:00
if ($rdver -eq "1.2.3")
2023-08-28 23:00:56 +02:00
{
2023-10-10 21:46:33 +02:00
Write-Output "RustDesk $rdver is the newest version."
Exit
2023-08-28 23:00:56 +02:00
}
2023-10-01 13:57:32 +02:00
if (!(Test-Path C:\Temp))
{
New-Item -ItemType Directory -Force -Path C:\Temp > null
2023-08-28 23:00:56 +02:00
}
2023-08-31 22:05:54 +02:00
cd C:\Temp
2023-08-28 23:00:56 +02:00
2023-10-23 22:08:29 +02:00
Invoke-WebRequest "https://github.com/rustdesk/rustdesk/releases/download/1.2.3/rustdesk-1.2.3-x86_64.exe" -Outfile "rustdesk.exe"
2023-08-28 23:00:56 +02:00
Start-Process .\rustdesk.exe --silent-install -wait
```
2023-10-20 14:36:29 +02:00
2023-10-21 21:56:52 +02:00
### `Key mismatch` error
Please configure your client with [correct key](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/relay/).
### `Failed to connect to relay server` error
Please make sure `hbbr` is running. More information about `hbbr`, you can find [here](https://rustdesk.com/docs/en/self-host/rustdesk-server-oss/install/).
If your `hbbr` does not run on the same machine of `hbbs`, or you have multiple relay servers, or you do not run it on default port `21117`, you have to tell it to `hbbs` explicitly. Please check [here](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/relay/).
2023-10-20 14:36:29 +02:00
2023-11-30 11:40:27 +01:00
### Reset MFA for Admin account
https://github.com/rustdesk/rustdesk/discussions/6576