Command Line support

[Midnex]

Would like to see command line support so I can add RustDesk to env variables, and push an id as an argument along with ability to push a password if needed.

Of course the command line interface would need to support other things as well, but this support would be a nice addition.

This feature could also be used to drop shortcuts on to the users desktop, that calls RustDesk and connects to a saved id in the shortcut file. Similar to how AnyDesk does it.

[rustdesk]

drop shortcuts

1.1.6

[rustdesk]

https://support.anydesk.com/Command_Line_Interface

[Midnex]

Glad to see this reopened.

[rustdesk]

Because someone mentioned this on discord, and I have been investigating on AnyDesk/TeamViewer/Parsec API lately.

[radiobut]

It would be very nice to be able to start a connection from the command line. For example, to integrate with other remote connection management tools.

[bilogic]

Teamviewer https://community.teamviewer.com/English/kb/articles/34447-command-line-parameters

I normally use teamviewer.exe -i <id>, and it prompts for password, very useful if there are many machines to manage.

[rustdesk]

--connect <id>

[bilogic]

--connect <id>

wow thanks! is it documented anywhere?

[Shahin-rmz]

Hello,
A power user (not a dev) here.
First:
Rustdesk is WAY better than Anydesk or Teamviewer.
I have installed it on my parent's Raspberry pi.
and can control the Raspberry remotely and play Movie for them.
Thanks <3

Now a question:

---

Can I connect via SSH and generate a password, (or see the password) and then connect via client to the Raustdesk?

---

Thanks

[bilogic]

Can I connect via SSH and generate a password, (or see the password) and then connect via client to the Raustdesk?

Are you suggesting this is more secured than having a static complex password on rustdesk?

Frankly, I think it takes the same flow and effort to steal your static complex password vs your SSH password/key.

[Shahin-rmz]

Frankly, I think it takes the same flow and effort to steal your static complex password vs your SSH password/key.

You are right.
Ultimately I like to:

• have a dynamic password for every new connection every time but a static password for trusted connections.
  Or other way around,
• trusted connections make a pair of password each time.

[bilogic]

Haha, we are going in circles: how do you determine if a connection is a trusted one?

Teamviewer does it by having 2 passwords, a dynamic one and static one, either one will allow you to login.

The closest I can think of is to have the dynamic password regenerate after each disconnection, but the static remains and is available to all connections, just make sure to keep it complex.

[Shahin-rmz]

Haha, we are going in circles: how do you determine if a connection is a trusted one?

You are right. :) I am thinking that if both parties check the trusted box, then we the connections are trusted.

The closest I can think of is to have the dynamic password regenerate after each disconnection, but the static remains and is available to all connections, just make sure to keep it complex.

This is one good approach, the other one is to have static password just for some connections and not global.

[paulbdavis]

Jumping in this issue to say it would be good to be able to get the current ID and password via the command line.

The use case is having a machine that's out in the field where there is not someone present to read off the ID and password or interact with the UI component (the UI would not even be launched). It would be good to dump these out on the command line when connected to said machine via SSH

like:

$ rustdesk --info

ID: 123 123 123
Password: abcdef

[paspo]

you can read ID and password from the config files:

• C:\Windows\ServiceProfiles\LocalService\AppData\Roaming\RustDesk\config\RustDesk.toml (windows)
• /root/.config/rustdesk/RustDesk.toml (linux)
• /Library/Preferences/com.carriez.RustDesk/RustDesk.toml (OSX)

(password can be salted)

[593172440]

1.2.0 ID encryption。How else can I obtain it？

[mooleshacat]

No you cannot.

enc_id = '00C4zmeQKHtMzP+cxTTLMQaLSObEIVVWl8'
password = ''

As you can see, the ID is encrypted and the password is non-existant.

[knro]

Jumping in this issue to say it would be good to be able to get the current ID and password via the command line.

The use case is having a machine that's out in the field where there is not someone present to read off the ID and password or interact with the UI component (the UI would not even be launched). It would be good to dump these out on the command line when connected to said machine via SSH

like:

$ rustdesk --info

ID: 123 123 123
Password: abcdef

This is exactly our use case. We need to a use to programatically retrieve the ID. We can set password it's sad to see no way to get ID for field deployments. It's OK if this action is only limited to root, that's not the issue. @rustdesk When can we expect this important feature to be implemented? Onyx47@ed9e92f seems like a good solution.

[ksingh7]

@knro did this worked for you ?

[shanjunmei]

Highly recommend this, I can only precompile one client per client right now, built in id and password ,is there any body can share a document ,how to pre-config it

[gezusk]

I saw the option to rename the Windows installer file to include the relay server and public key. Is it possible to provide those via cmd line instead of creating a really....really long filename?

[mooleshacat]

I think that method was jenk
They should have allowed command line args.

[christovic]

Just chiming in here to say that this is really, really useful in managed deployments with MDM.

[SergeyMy]

so it's all done!
remotely via ssh:

1. installation - yes
2. rendezvous_server setting - yes
3. relay-server setting - yes
4. api-server setting - yes
5. setting KEY_PUB - yes
6. get ID - yes (--get-id)
7. set a permanent password - yes (--password)

[gezusk]

@0x100001 I'm interested in pro...but can't find much information about it, or a demo.

[SergeyMy]

if you need to install on more than a couple of systems .... it's strange that there is no smart programmer even in the web ... in the PRO version you will get at least a web api, where all clients themselves will report their IDs
PS
you don't even need a programmer to find out the ID! just look at sqlite db :) on yours!!! server hbbs
sqlite3 -column db_v2.sqlite3 "select id,created_at,user,note,info,status,uuid,hex(guid) from peer;"

[0x100001]

@gezusk contact: sales@rustdesk.com
They will help you.

@SergeyMy I do that. There is a free version of my monitoring software just for that. Feel free to contact me.

[AlexandreBonneau]

Using ssh, I was able to install the flatpak version of rustdesk on a Debian box.
I can run --get-id to retrieve the id, however when I try to run flatpak run com.rustdesk.RustDesk --password foobar, I get the following error message:
Installation and administrative privileges required.
I tried running the same command with root, to no avail.
Any ideas how to fix that?

[shahg2]

Hi alexandre, did you find the solution to this. iam facing this issue in Windows. Normal rustdesk.exe password can be set but if i customized the rustdesk client and run cli --password i get this message. whereas with rustdesk.exe -- password i can set password and it will show done. but with custom client it will show "Installation and administrative privileges required!"

[SergeyMy]

@SergeyMy I do that. There is a free version of my monitoring software just for that. Feel free to contact me.

you need? help with developing and testing web api pro lite? ( ;) smile)

<?php
......
//********************************************* MAIN POST ********************
if($islog) foreach ($_SERVER as $key => $val)    {    fwrite($file, $key . ' => ' . $val . "\n");    }
foreach ($_REQUEST as $key => $val)
 {
    if($islog) fwrite($file, $key . ' => ' . $val . "\n");

if (stristr($key, 'api/heartbeat'))   {
    header('HTTP/1.1 200 Ok');
    header('Content-Type: application/json');
    $arr = array('modified_at' => 12);
    echo json_encode($arr);
    }
}
?>

[0x100001]

I think I might didn't explain it correctly. I coded a RustDesk integration for my monitoring software, including monitoring the RustDesk service, enforcing a custom relay server, reading id & password, generating a password and stuff like that. I sadly dont have the time capacities to work on other projects than mine. :/

[chris-31337]

Hi all, do you know if there has been progress on password-passing via command-line during --connect, preferably via Stdin as suggested by merlink01 above and as implemented in Anydesk?

While I am currently following bilogic's suggestion above to store the password in Rustdesk, I would like to store connection files (e.g. batch files to execute rustdesk.exe --connect ID plus password) for specific hosts in an encrypted volume for added security (without relying on full-device encryption to encrypt ALL passwords stored by Rustdesk under %AppData%\RustDesk\config\peers in Windows).

[dinger1986]

The link then links to the code where all the command options are

[chris-31337]

Thank you! I went through that code already but apparently missed the right command-line to pass a password. Could you point me in the right direction?

[dinger1986]

I'd have to read through the code to remind myself, I'm sure it's something like rustdesk.exe --connect id password=password if you get it working feel free to add to the docs for the next person

[chris-31337]

Thank you! In my ignorance, I did not expect password to have a dual function in addition to what is written in the docs. As you suggested, RustDesk.exe --connect ID --password PASSWORD works.

However, I am still curious if there is a way to more securely pass the password using Stdin as already suggested by merlink01, since the password supplied via --password can be read from memory while the connection is open. cmd /c echo PASSWORD | RustDesk.exe --connect ID or cmd /c echo PASSWORD | RustDesk.exe --connect ID --password (which is how I pass the password via Stdin to Anydesk) did not work in my tests.

[ivoryblade]

Hello! Let me join your discussion. Tell me please is there any way to pass arguments on Mac/linux clients? And it would be most wanted if one can use some universal way to start connection from external remote management software win/Mac/linux

[plittlefield]

Hi Folks,

This would be great.

I tried rustdesk --help and it just fires up the GUI in X again.

Is there a document for all the command line options on Linux please?

Paully

[dilawar]

I am also baffled about this behaviour? sudo rustdesk --get-id prints the id of the desk but without sudo, it tries to launch the app!!

[thiswillbeyourgithub]

FYI I made a FR to ask for a --help argument at #9484

[thiswillbeyourgithub]

For anyone still wondering what command line arguments are currently available, take a look at the file src/core_main.rs and do ctrl+f for '--'.

I'm not sure there are other arguments than those.

Edit: in #9484 I made a request to add a --help argument

[gitterspec]

For anyone still wondering what command line arguments are currently available, take a look at the file src/core_main.rs and do ctrl+f for '--'.

I'm not sure there are other arguments than those.

Edit: in #9484 I made a request to add a --help argument

Thanks for this. However, I can't seem to find the values that --option can take. The code seems to call get_options but looking at that function doesn't seem to give much insight. Anyone have some idea?

[lazee486]

go to the network tab in rustdesk after youve added your server and key, click the export button on top right...gives you a encoded string

then run rustdesk.exe --config =0nI9Ajeh9GWRdlSJBFc0F1VpZDTCxUYjlEeItkWxZWZnxUWBd3Srp0Z4gFWNxkI6ISsdfhshsdhsdhIiI6ISehxWZyJCLiEmeu82YuQXa5xGcdhdhdhjsdfhciojI0N3boJye

thats a garbage key just as an example... https://rustdesk.com/docs/en/self-host/client-deployment/ has the scripts - use that same string you exported in the config = " " field to preconfigure for your deploys.

[lazee486]

rustdesk.exe --config =0nI9Ajeh9GWRdlSJBFc0F1VpZDTCxUYjlEeItkWxZWZnxUWBd3Srp0Z4gFWNxkI6ISsdfhshsdhsdhIi

shortened it so people can see its meant to be a single line command

other useful
rustdesk.exe --silent-install
rustdesk.exe --install-service
rustdesk.exe --get-id (returns id)
rustdesk.exe --password myshittypassword (sets password)

[rustdesk]

rustdesk.exe --connect <id> --password <password>
rustdesk.exe --config <config-string>
rustdesk.exe --silent-install
rustdesk.exe --install-service
# get id
rustdesk.exe --get-id
# set password
rustdesk.exe --password myshittypassword
# set id
rustdesk.exe --set-id <id>

please run --config, --password, --set-id with administrative privilege, and make sure RustDesk is installed rather than run as portable version.

By default rustdesk.exe in command line on Windows has no output, you have to run it like below.

• cmd.exe: rustdesk.exe <args> | more, e.g. rustdesk.exe --get-id | more
• PowerShell: rustdesk.exe <args> | Out-String, e.g. rustdesk.exe --get-id | Out-String

Assign Device Users/Groups/Strategies to Devices for self-hosting Pro

https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices

[rustdesk]

rustdesk/src/core_main.rs

Line 174 in faf97c7

if args[0] == "--uninstall" {

rustdesk/src/core_main.rs

Line 573 in faf97c7

"--connect" | "--play" | "--file-transfer" | "--port-forward" | "--rdp" => {

[gxsalles]

Thanks for the tip, however ,using "CMD" it was necessary to include .\ at the beginning of the command

.\rustdesk.exe --password myshittypassword

[wadson-dev]

rustdesk.exe --connect <id> --password <password>
rustdesk.exe --config <config-string>
rustdesk.exe --silent-install
rustdesk.exe --install-service
# get id
rustdesk.exe --get-id
# set password
rustdesk.exe --password myshittypassword
# set id
rustdesk.exe --set-id <id>

please run --config, --password, --set-id with administrative privilege, and make sure RustDesk is installed rather than run as portable version.

By default rustdesk.exe in command line on Windows has no output, you have to run it like below.

• cmd.exe: rustdesk.exe <args> | more, e.g. rustdesk.exe --get-id | more
• PowerShell: rustdesk.exe <args> | Out-String, e.g. rustdesk.exe --get-id | Out-String

Assign Device Users/Groups/Strategies to Devices for self-hosting Pro

https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategies-to-devices

rustdesk.exe --password myshittypassword

Ran this command as elevated user and had no change in password, still using one-time password. Was this expected?
In resume, no change at all

[621625]

I second this. Rustdesk should have a CLI. I'm on Linux. I want it and I expect it. And I love rustdesk.

[mitenpetal]

Can someone please help me to setup a client on Linux machine ?
what I want is config added , add to addressbok , add to device group and , user group and last password add Is it possible ?
Please help me with terminal command , I am using rocky linux

thank you

[mitenpetal]

https://rustdesk.com/docs/en/self-host/rustdesk-server-pro/console/#assign-device-usersgroupsstrategiesdevicegroup-to-devices
Thank you this way it is working.

It has worked but not entirely. Which group has space in between names for that it is not working, Is there Any solution for that?

[austinbutler]

Guessing there's no way to accept the share prompt via SSH/command line?

[shahg2]

I am using a custom-built RustDesk client named customclient.exe.The client is successfully installed as a service and the service is actively Running.I am executing the command with full Administrative privileges to set permananet password.
However, when I run the standard command, I receive an error, while the original RustDesk.exe works fine: Custom customclient.exe Failure: .\customclient.exe --password XXX | more $\rightarrow$ Installation and administrative privileges required!
Since the service is confirmed running, the issue seems to be an internal check failure within the custom build.What specific component in the RustDesk source code might be missing, or what configuration key might be different in the custom build that prevents the CLI command from recognizing the installed service and updating the configuration file?
Specifically, is there a hardcoded internal check for the executable name or a service name/path mismatch that causes the --password command to fail its service-status check?