Table of Contents
Was this article helpful?

4  out of  9 found this helpful

Try Vultr Today with

$50 Free on Us!

Want to contribute?

You could earn up to $600 by adding new articles.

How to Install RustDesk Remote Desktop Server on Ubuntu

Last Updated: Thu, Aug 25, 2022
System Admin


RustDesk is an open-source remote desktop solution that gives you full control of your remote connections through a self-hosted private server. It's an alternative to closed-source applications such as TeamViewer and AnyDesk with a lightweight, privacy-centric interface.

This guide describes how you can install the RustDesk remote desktop server on Ubuntu, and connect remote devices using a RustDesk client application.


Before your begin, make sure you:

RustDesk is lightweight, and you can install it on an existing Ubuntu server running docker.

A subdomain masks your direct public server IP Address protecting it from potential attacks.

1. Install RustDesk

  1. Create a new directory to store RustDesk docker files.

     $ sudo mkdir -p /opt/rustdesk
  2. Switch to the directory.

     $ sudo cd /opt/rustdesk
  3. Create a new rustdesk.yml file.

     $ sudo touch rustdesk.yml
  4. Edit the file using a text editor like Nano.

     $ sudo nano rustdesk.yml
  5. Add the following configurations to the file.

     version: '3'
         external: false
          container_name: hbbs
          - 21115:21115
          - 21116:21116
          - 21116:21116/udp
          - 21118:21118
        image: rustdesk/rustdesk-server:latest
        command: hbbs -r -k _
           - ./hbbs:/root
           - rustdesk-net
           - hbbr
        restart: unless-stopped
           container_name: hbbr
           - 21117:21117
           - 21119:21119
        image: rustdesk/rustdesk-server:latest
        command: hbbr -k _
           - ./hbbr:/root
           - rustdesk-net
        restart: unless-stopped

    Save and close the file.

  6. Start the RustDesk server containers.

     $ sudo docker-compose -f rustdesk.yml up -d
  7. Verify that RustDesk hbbs, hbbr containers are up and running.

     $ sudo docker ps

2. Secure the Server

While using RustDesk directly in a local development environment is safe, this would expose your backend port in production. To safely use RustDesk, set up Nginx as a reverse proxy to serve requests through a subdomain to the backend hbbs and hbbr ports.

  1. First, allow Nginx to communicate on HTTP 80 through the default firewall (UFW).

     $ sudo ufw allow 80/tcp
  2. Reload Firewall rules.

     $ sudo ufw reload
  3. Create a new Nginx configuration file.

     $ sudo touch /etc/nginx/conf.d/rustdesk.example.conf
  4. Edit the file.

     $ sudo nano /etc/nginx/conf.d/rustdesk.example.conf
  5. Add the following configuration to the file.

     server {
         listen 80;
         listen [::]:80;
     # Set your subdomain
     # Proxy Requests to the RustDesk host port
         location / {
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;

    Save and close the file.

  6. Test the Nginx configuration for errors.

     $ sudo nginx -t
  7. Restart Nginx.

     $ sudo systemctl restart nginx

View RustDesk Server Encryption Keys

Based on your Docker compose configuration, the RustDesk server encrypts all connections based on your public key available in the hbbs directory. Any RustDesk client without the key cannot connect through the relay server.

  1. View and copy your server public key.

     $ cat /opt/rustdesk/hbbs/
  2. Your Output should look like the one below.


3. Configure the RustDesk Client

  1. On a client machine, download the RustDesk client application from the official website.

  2. Install the application on the client computer.

  3. Open the RustDesk application.

  4. Click the settings 站ョ button next to your connection ID.

  5. Select ID/Relay Server from the list of options.

  6. Enter your server's domain name in the ID Server field.

  7. Enter the server public key in the Key field.

  8. Click OK to save changes and establish a connection to your RustDesk server.

  9. Copy the remote computer ID and password, or click Settings, navigate to Change ID and set it to your preferred value.

4. Test the Server

  1. On your local computer, download and install the RustDesk client.

  2. Open the application, and navigate to ID/Relay Server.

  3. Enter your RustDesk server's domain name in the ID Server: field.

  4. Enter the server public key.

  5. Click OK to save changes.

  6. Enter your remote machine ID in the Enter Remote ID field.

  7. Click Connect to establish a connection through your RustDesk server to the remote machine.

  8. Your remote computer's desktop displays. The connection should feel fast and encrypted as your data routes through a single private RustDesk server.


You have successfully installed RustDesk server on Ubuntu and established a connection to a remote machine. The client application is available for Windows, Linux, macOS, Android, and iOS devices. For more information, please visit the official RustDesk documentation.

Want to contribute?

You could earn up to $600 by adding new articles.