How to Install RustDesk Remote Desktop Server on Ubuntu

Updated on February 9, 2024
How to Install RustDesk Remote Desktop Server on Ubuntu header image


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:

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.