Skip to main content
The Cyberdriver CLI is useful when you bake a Windows AMI or golden template, then clone many VMs from it. The main rule is simple: install Cyberdriver in the image, but connect each cloned VM with its own API key and identity when it first boots.

​
Install on Windows

Use the PowerShell installer script in Cyberdriver Quickstart. That page is the source of truth for installing Cyberdriver, adding it to PATH, and verifying the CLI. The current Windows installer requires Administrator because it installs Cyberdriver as a system service. You can run the Cyberdriver app as a normal user after installation, but a fully non-admin Windows install is not currently supported by the public Cyberdriver MSI.

​
Common commands

After using the installer script above, restart PowerShell and Cyberdriver.exe should be available from any directory:
config-print shows the current Cyberdesk environment, API base, Cyberdesk machine fingerprint, RustDesk peer ID, and whether the API key is configured. For scripts, resolve the executable from PATH instead of assuming a drive letter:

​
Join Cyberdesk

Run this on the VM after it boots:
For dev:
For a custom API host:

​
Build an AMI or Image

1

Install Cyberdriver in the image

Install the Cyberdriver MSI while preparing your base Windows image.Do not join Cyberdesk in the base image unless you generate a new identity before each clone starts.
2

Add first-boot bootstrap

Configure your launch script, user data, or image init process to run:
--new-identity resets both pieces of machine identity: the Cyberdesk fingerprint and the RustDesk peer ID/keypair. Use this for AMIs, templates, and cloned hosts. Reinstalling or updating Cyberdriver without this flag preserves identity.
3

Set a display name

Pass a name when the VM first joins:
Names are optional but make large fleets much easier to manage.
4

Verify registration

After boot, check:
Then confirm the desktop appears in the Cyberdesk dashboard.

​
Remote keepalive from a host

If a host machine runs the remote desktop software for many VMs, you can register that host as the remote keepalive machine for a VM:
The same value can be configured in Cyberdriver → Settings → Network → Remote keepalive for. See Keepalive for the full host + VM explanation.

​
Useful flags

​
Troubleshooting

If cloned VMs overwrite each other in the dashboard, the image was cloned with persisted identity. Run:
If the VM does not appear connected, check logs:
If you use a host-level remote keepalive Cyberdriver, make sure the host and VM API keys belong to the same Cyberdesk organization.