[SERVICE REQUEST] RustDesk Server (Open-Source TeamViewer Alternative)

[ali2000hos]

Service Name

RustDesk Server (hbbs & hbbr)

What is this service?

RustDesk is a full-featured, open-source remote desktop application, written in Rust. It serves as a highly popular, privacy-respecting alternative to TeamViewer and AnyDesk.

While the client app can use public servers, self-hosting the RustDesk Server allows you to establish secure, fast, and entirely private remote desktop connections using your own infrastructure. The server consists of two main components: hbbs (ID/Rendezvous server) and hbbr (Relay server).

Official Website

https://rustdesk.com/

GitHub Repository

• Client: https://github.com/rustdesk/rustdesk
• Server: https://github.com/rustdesk/rustdesk-server

Docker Image(s)

RustDesk provides official Docker images for the server components.

• Docker Hub: rustdesk/rustdesk-server
• Docker Compose Example: https://rustdesk.com/docs/en/self-host/install/

Why should this be added to Coolify?

An open-source, self-hosted remote desktop solution is a massive requirement for many homelabbers, IT admins, and small businesses wanting to move away from the strict licensing and privacy concerns of TeamViewer or AnyDesk.

However, deploying the RustDesk server manually can be a bit tricky for beginners because it requires running two separate services (hbbs and hbbr) and configuring several specific TCP and UDP ports for NAT punching and relaying. Having a one-click template in Coolify that automatically links the ID and Relay servers and exposes the correct ports would be an incredible addition to the platform!

[svk27]

Maybe try this and let me know if this works for you :]

name: rustdesk

# Coolify notes:
# - Do not deploy this as "Raw Compose Deployment"; the SERVICE_* variables below
#   rely on Coolify's compose magic environment variable handling.
# - SERVICE_FQDN_RUSTDESK lets the user assign/edit the public RustDesk hostname
#   in Coolify. RustDesk clients should use that hostname with the published
#   RustDesk ports, normally 21116 for the ID server and 21117 for the relay.
# - SERVICE_URL_RUSTDESK_21118 and SERVICE_URL_RUSTDESK_21119 ask Coolify's
#   reverse proxy to route the optional web-client websocket paths to hbbs/hbbr.
# - The core RustDesk protocol uses raw TCP/UDP, so those ports are published
#   directly on the host and must also be allowed through the server firewall.

services:
  hbbs:
    image: rustdesk/rustdesk-server:${RUSTDESK_VERSION:-latest}
    restart: unless-stopped
    command:
      - hbbs
      - -r
      - ${SERVICE_FQDN_RUSTDESK}:${RUSTDESK_HBBR_PORT:-21117}
    depends_on:
      hbbr:
        condition: service_started
    environment:
      - SERVICE_FQDN_RUSTDESK
      - SERVICE_URL_RUSTDESK_21118=/ws/id
      - ALWAYS_USE_RELAY=${ALWAYS_USE_RELAY:-N}
      - RUST_LOG=${RUST_LOG:-info}
    volumes:
      - rustdesk-data:/root
    expose:
      - "21118"
    ports:
      - "${RUSTDESK_HBBS_NAT_PORT:-21115}:21115/tcp"
      - "${RUSTDESK_HBBS_PORT:-21116}:21116/tcp"
      - "${RUSTDESK_HBBS_PORT:-21116}:21116/udp"
      - "${RUSTDESK_HBBS_WS_PORT:-21118}:21118/tcp"

  hbbr:
    image: rustdesk/rustdesk-server:${RUSTDESK_VERSION:-latest}
    restart: unless-stopped
    command:
      - hbbr
    environment:
      - SERVICE_FQDN_RUSTDESK
      - SERVICE_URL_RUSTDESK_21119=/ws/relay
      - RUST_LOG=${RUST_LOG:-info}
    volumes:
      - rustdesk-data:/root
    expose:
      - "21119"
    ports:
      - "${RUSTDESK_HBBR_PORT:-21117}:21117/tcp"
      - "${RUSTDESK_HBBR_WS_PORT:-21119}:21119/tcp"

volumes:
  rustdesk-data: