Rustdesk Server Pro License Key Install
| Problem | Solution | |---------|----------| | "Invalid license key" | Double-check for typos. The key is case-sensitive. | | "License expired" | Contact RustDesk sales to renew. | | Web console shows "Free version" | Restart the service after entering the license. | | Docker container won't start with license | Ensure the license string has no spaces or special characters. |
The Pro server automatically creates a key pair in the ./data directory (id_ed25519.pub). You need this for clients.
View it:
cat ./data/id_ed25519.pub
It looks like: t0B+mfBNnW9bDkP4iX8kL9cZ....
This is the fastest way to get the Pro server running with your license.
Step 1: Create the directory
mkdir ~/rustdesk-pro && cd ~/rustdesk-pro
Step 2: Create docker-compose.yml
Paste the following. Crucially, you will add your license key here.
version: '3'services: hbbs: image: rustdesk/rustdesk-server-pro:latest container_name: rustdesk-hbbs-pro command: hbbs volumes: - ./data:/root environment: - ENCRYPTED_ONLY=1 - RUSTDESK_LICENSE=<YOUR_LICENSE_KEY_GOES_HERE> # <-- CRITICAL LINE network_mode: host restart: unless-stopped
hbbr: image: rustdesk/rustdesk-server-pro:latest container_name: rustdesk-hbbr-pro command: hbbr volumes: - ./data:/root environment: - RUSTDESK_LICENSE=<YOUR_LICENSE_KEY_GOES_HERE> # <-- SAME KEY HERE network_mode: host restart: unless-stopped
rustdesk-web: image: rustdesk/rustdesk-web-pro:latest container_name: rustdesk-web-pro environment: - API_SERVER=ws://<YOUR_SERVER_IP>:21114 ports: - "80:80" restart: unless-stopped
Step 3: Insert your license key
Replace <YOUR_LICENSE_KEY_GOES_HERE> with the actual key (e.g., RDPRO-XXXXX-YYYYY-ZZZZZ). rustdesk server pro license key install
Step 4: Launch the containers
docker-compose up -d
Step 5: Verify activation
docker logs rustdesk-hbbs-pro
Look for: [INFO] License valid. Welcome to RustDesk Pro
For changes to take effect, restart the server.
For binary installations, edit the configuration file:
nano /etc/rustdesk-server-pro/config.toml
Add this line:
license = "your-license-key-here"
Save and restart the service:
systemctl restart rustdesk-server-pro
docker restart rustdesk-pro-container-name
Or, if using docker-compose:
docker-compose down && docker-compose up -d
If you want to move your Pro license to a new server:
Note: You can usually reactivate a server up to 3 times per month without contacting support.
If your license key doesn't activate, check these common pitfalls:
| Symptom | Likely Cause | Solution |
| :--- | :--- | :--- |
| License key not set | Missing environment variable | Run echo $RUSTDESK_LICENSE. If empty, export it. |
| Invalid signature | Using OSS binary instead of Pro binary | Download rustdesk-server-pro-*, not rustdesk-server-*. |
| License server unreachable | Firewall blocking outbound HTTPS | Allow outbound TCP 443 to license.rustdesk.com. |
| Server count exceeded | One license per ID server | Deactivate old server via web dashboard before installing new one. |
| Expired license | Subscription ended | Renew at RustDesk pricing page. | | Problem | Solution | |---------|----------| | "Invalid