doc.rustdesk.com/content/self-host/client-configuration/_index.en.md

117 lines
6.2 KiB
Markdown
Raw Normal View History

2023-08-28 22:05:14 +02:00
---
2023-08-29 05:37:35 +02:00
title: Client Configuration
weight: 300
2023-08-29 05:45:11 +02:00
pre: "<b>2.3. </b>"
2023-08-28 22:05:14 +02:00
---
### Overview
2023-10-01 13:51:00 +02:00
There are a number of ways to configure RustDesk Clients to use your own self-hosted server, we will cover some below.
2023-08-28 22:05:14 +02:00
2023-11-23 10:37:44 +01:00
### 1, Manual Config
2023-08-28 22:05:14 +02:00
2023-09-05 00:01:31 +02:00
In the main RustDesk Client home click on the Menu button [ &#8942; ] next to your ID then click on Network, you can now unlock the settings using elevated privileges and set your ID, Relay, API and Keys.
2023-08-28 22:05:14 +02:00
2023-10-21 21:49:28 +02:00
![](/docs/en/self-host/client-configuration/images/network-config.png)
2023-08-28 22:15:42 +02:00
2023-08-29 05:37:35 +02:00
Enter the `hbbs` host or IP Address in the **ID Server** input box (local side + remote side). The other two addresses can be left blank, RustDesk will automatically deduce (if not specially set), and the Relay Server refers to `hbbr` (port 21117).
e.g.
```nolang
hbbs.example.com
```
or
```nolang
hbbs.example.com:21116
```
2023-11-23 10:37:44 +01:00
#### Set `Key`
2023-10-20 19:39:38 +02:00
2023-10-20 19:41:31 +02:00
As a `Pro` user you will be able to retrieve the `Key` from the [web console](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/), or you can find it in `id_ed25519.pub` file under your working directory.
2023-10-20 14:27:45 +02:00
![](/docs/en/self-host/rustdesk-server-pro/console/images/console-home.png?v2)
2023-10-11 14:19:24 +02:00
2023-11-23 10:37:44 +01:00
#### Set `API Server`
2023-10-21 21:49:28 +02:00
This is for `Pro` user only. When you can log in on web console, but fail to log in on RustDesk client, it probably you have not set `API Server` correctly.
2023-10-20 19:32:50 +02:00
2023-10-21 22:05:19 +02:00
If your API Server does not run on default `21114` port, please specify `API Server` explicitly.
e.g. your API Server runs on default https port, please specify `API Server` with `https://hbbs.example.com`.
2023-10-20 19:32:50 +02:00
2023-10-21 22:05:19 +02:00
If you still can not confirm the value of `API Server`, please go to the welcome page of web console, the `API Server` is shown in above picture (The input box with `API:` label).
2023-10-20 19:32:50 +02:00
2023-11-23 10:37:44 +01:00
### 2, Setup Using Import or Export
2023-08-30 13:25:28 +02:00
2023-10-21 21:49:28 +02:00
1. Use the steps [above](https://rustdesk.com/docs/en/self-host/client-configuration/#manual-config) to configure RustDesk Client on a Device.
2023-09-05 00:01:31 +02:00
2. Using the above machine go to Settings then Network and unlock.
3. Click on `Export Server Config`.
4. Paste the copied string into Notepad or similar.
5. Go to new client, copy the above to clipboard.
6. Go to Settings then Network in RustDesk Client, unlock and click `Import Server Config`.
7. It will automatically paste the settings in.
8. Click `Apply`.
2023-08-29 05:37:35 +02:00
2023-11-23 10:37:44 +01:00
### 3, Automatic Config
2023-08-28 22:32:32 +02:00
2023-08-31 21:56:30 +02:00
The easiest way to setup automatically is using deployment scripts found [here](https://rustdesk.com/docs/en/self-host/client-deployment/).
2023-08-28 22:32:32 +02:00
2023-09-05 00:01:31 +02:00
You can fix the Password is required and use a reverse Base64 string in the format `{"host":"HOSTADDRESS","key":"HOSTKEY","api":"http://HOSTADDRESS:21114"}` to automatically configure the clients, this is available automatically with RustDesk Server Pro via the console.
2023-08-30 13:25:28 +02:00
2023-10-21 21:49:28 +02:00
You can also use the steps from [above](https://rustdesk.com/docs/en/self-host/client-configuration/#setup-using-import-or-export) to export the string, remove any `=` at the start or end of the string. Restart RustDesk Client if settings don't show.
2023-08-28 22:32:32 +02:00
2023-11-23 10:37:44 +01:00
### 4, Put config in rustdesk.exe file name (Windows only)
2023-08-28 22:32:32 +02:00
2023-08-29 05:37:35 +02:00
Change `rustdesk.exe` to rustdesk-`host=<host-ip-or-name>,key=<public-key-string>`.exe, e.g. rustdesk-`host=192.168.1.137,key=xfdsfsd32=32`.exe. You can see the config result in the About Window below.
2023-08-28 22:32:32 +02:00
2023-10-20 14:30:30 +02:00
As a `Pro` user you will be able to retrieve the whole encrypted string from the [web console](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/) then download and rename the RustDesk Client exe, you can upload this somewhere easy for your customers to use.
2023-09-14 16:11:17 +02:00
2023-10-20 14:22:07 +02:00
![](/docs/en/self-host/rustdesk-server-pro/console/images/console-home.png?v2)
2023-08-29 05:37:35 +02:00
<a name="invalidchar"></a>
{{% notice note %}}
You need to set both `host` and `key`, missing either one will not work.
2023-08-28 22:32:32 +02:00
2023-08-29 05:37:35 +02:00
Optionally add a `,` (comma) character after the key, before the `.exe` part as a delimiter, to avoid the key being mangled if Windows or the browser renames the file when downloading duplicated names.
2023-08-28 22:32:32 +02:00
2023-08-29 05:37:35 +02:00
If there are invalid characters in the key which can not be used in a Windows file name, please remove the
`id_ed25519` file from your server and restart `hbbs`/`hbbr`. This will cause the `id_ed25519.pub` file to regenerate. You may need to
repeat this process until you get valid characters.
{{% /notice %}}
2023-08-28 22:32:32 +02:00
2023-11-29 14:52:32 +01:00
#### add `--` to the name
At the end, add `--`.
Example: `rustdesk-licensed--{encrypted string}--.exe`
We have noticed that in some cases, when double downloaded, something like `copy (1)` is added to the end of the file name, and this ruins the config.
By adding `-- `at the end right after our config string, even if something is added to the file name, it won't corrupt the config string, and RustDesk will correctly retrieve it.
{{% notice note %}}
{{% /notice %}}
2023-11-23 10:37:44 +01:00
### 5, [Hardcoding](https://rustdesk.com/docs/en/self-host/client-configuration/hardcode-settings/)
2023-10-20 14:19:23 +02:00
2023-09-12 23:29:54 +02:00
### Logging your user in (RustDesk Server Pro)
2023-09-13 23:21:18 +02:00
To sign in with RustDesk Server Pro, ensure your client is setup correctly, click on `Settings` and click `Account` and then `Login`, enter username and password and then Login.
2023-09-12 23:29:54 +02:00
### Taking Control of other machines
Before Taking Control when using with RustDesk Server Pro ensure you are logged in.
2023-09-13 23:21:18 +02:00
After that you can enter the client ID and password of the machine you want to take control of and click `Connect`.
2023-09-12 23:29:54 +02:00
2023-09-13 23:21:18 +02:00
### Address book (RustDesk Server Pro)
To add devices to your address book, after you have connected to a device they will be in your recent sessions, next to the device you can now click the Menu button [ &#8942; ] and add to your address book, if you have saved the password and set permanent passwords on the client this will also be synced across devices you log in to to allow access from anywhere.
2023-09-12 23:29:54 +02:00
2023-10-01 13:51:00 +02:00
You can add and assign Tags in your address book to help organize devices as well as search for them.
2023-09-24 15:15:11 +02:00
2023-10-01 13:51:00 +02:00
### Group (RustDesk Server Pro)
2023-10-21 21:49:28 +02:00
By default once signed in all devices connected to your RustDesk Server Pro will show up in group, (you will still need the passwords for unattended access but all devices are now there), it will show any other users in your group and if you assign cross group access in the web console it will show users [in those groups](https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#add-new-groups) as well.
2023-09-24 15:15:11 +02:00
2023-10-01 13:51:00 +02:00
If you would like to add devices to your own address book, you can click on the Menu button [ &#8942; ] next to the device and click `Add to address book`.
2023-10-21 21:49:28 +02:00