A service of Daily Data, Inc.
Contact Form

Unix Server Tech Knowledge Base

User Tools

Site Tools

Trace:
software:rust:server_devuan

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
software:rust:server_devuan [2025/09/18 08:16] – rodolicosoftware:rust:server_devuan [2025/09/29 16:51] (current) – rodolico
Line 1: Line 1:
 ====== RustDesk Server on Devuan ====== ====== RustDesk Server on Devuan ======
  
-<WRAP center round alert 60%> +<WRAP center round important 60%> 
-Warning. I am still editing this on 18 Sep 2025. Do not use these instructions until I have finished editing, then tested the procedure. This notice will be removed at that time.+The RustDesk Server must be accessible from any connecting clients on ports 21114-21119, TCP and UDP. If any workstation will be accessing from outside your network, you will need to forward those ports on your router to your server. Not all are required for all installations. See section //Open Ports// for more information.
 </WRAP> </WRAP>
- 
  
 We use [[https://www.devuan.org/|Devuan]] as an alternative to Debian as Devuan allows us to choose the init system instead of forcing the use of SystemD. With its many faults, we still choose SysVInit for our init system, and Devuan allows that. We use [[https://www.devuan.org/|Devuan]] as an alternative to Debian as Devuan allows us to choose the init system instead of forcing the use of SystemD. With its many faults, we still choose SysVInit for our init system, and Devuan allows that.
  
-The Rust Server install script unfortunately assumes SystemD, and will fail halfway through as it is attempting to set up the SystemD service. The same is true of the .deb package which is available.+An excellent Rust Server install script is available at [[https://github.com/techahold/rustdeskinstall/blob/master/install.sh|GitHub built by techahold]]. This script has a lot of extra features, but unfortunately, it assumes SystemD, and will fail halfway through as it is attempting to set up the SystemD service. The same is true of the .deb package which is available from RustDesk.
  
 This article describes how to set up the Rust Server on Devuan, and may be helpful for other systems also. This article describes how to set up the Rust Server on Devuan, and may be helpful for other systems also.
 +
 +
 +===== Open Ports =====
 +
 +On your firewall/NAT/whatever, you need ports <code>21114,21115,21116,21117,21118,21119</code> open and forwarded to the Rust Server. Additionally, to use the webui, you will need to open a port for that.
 +
 +Following table shows what the ports are used for.
 +
 +^Port   ^Purpose                ^Protocol^Notes^
 +| 21114 | HBBS (RustDesk server) | TCP     | Default port for API (not required)         |
 +| 21115 | HBBS (RustDesk server) | TCP/UDP | Default port for the RustDesk server.       |
 +| 21116 | HBBS (RustDesk server) | TCP/UDP | Used for client connections to the server.  |
 +| 21117 | HBBS (RustDesk server) | TCP/UDP | Additional port for server communication.   |
 +| 21118 | HBBS (RustDesk server) | TCP/UDP | Another port for server communication.      |
 +| 21119 | HBBS (RustDesk server) | TCP/UDP | Used for additional server functionalities. |
 +| 80 | HTTP (optional fallback) | TCP | Commonly allowed port for web traffic; can be used for fallback. |
 +| 443 | HTTPS (optional fallback) | TCP | Secure web traffic; can be used for fallback   |
  
 ===== Set up user ===== ===== Set up user =====
Line 28: Line 44:
 ===== Download Server ===== ===== Download Server =====
  
-Open a web browser to https://github.com/rustdesk/rustdesk-server/releases, locate the entry for //rustdesk-server-linux-amd64.zip//. Right click on it and select "Copy Link".+This will download the latest version of RustDesk Server from their github site. Second two lines stolen directly from techahold's script. He's a much better sh programmer than me.
  
 <code bash> <code bash>
 cd /tmp cd /tmp
-wget ###Paste the URL from above here###+LATEST=$(curl https://api.github.com/repos/rustdesk/rustdesk-server/releases/latest -s | grep "tag_name" | awk -F'"' '{print $4}') 
 +wget "https://github.com/rustdesk/rustdesk-server/releases/download/${LATEST}/rustdesk-server-linux-amd64.zip"
 unzip rustdesk-server-linux-amd64.zip unzip rustdesk-server-linux-amd64.zip
 mv /tmp/amd64/* /opt/rustdesk mv /tmp/amd64/* /opt/rustdesk
 chown rust:rust /opt/rustdesk/* chown rust:rust /opt/rustdesk/*
 +chmod 755 /opt/rustdesk/*
 </code> </code>
  
-This will create three binary files in /opt/rustdesk+This will get three binary files in /opt/rustdesk
   * hbbr - The relay server. If a direct P2P connection can not be made, this will be used to relay traffic between clients.   * hbbr - The relay server. If a direct P2P connection can not be made, this will be used to relay traffic between clients.
   * hbbs - this is the "signal" server. Your clients will ping this to notify they exist, and will use it to set up a connection between clients.   * hbbs - this is the "signal" server. Your clients will ping this to notify they exist, and will use it to set up a connection between clients.
Line 50: Line 68:
  
 **Note**: The check is made in the current working directory, so you **must** run hbbs from within it's home directory (/opt/rustdesk) **Note**: The check is made in the current working directory, so you **must** run hbbs from within it's home directory (/opt/rustdesk)
 +
 +<code bash>
 +cd /opt/rustdesk
 +echo Starting signaling server for testing. Press ^c to exit when you are happy
 +sudo -u rust ./hbbs
 +
 +echo Your key for the clients is
 +cat id_ed25519.pub
 +echo To find this again at a later date, just run the command cat id_ed25519.pub
 +
 +</code>
 +===== Set automatic run =====
 +
 +Everything up to this point will work on all Unix systems, and we have done nothing that techahold's install script will do faster, and more reliably. However, for the Unix systems which do not use SysV, we need a SysV init script. Actually two; one for hbbr and one for hbbs.
 +
 +Copy the following two files to /etc/init.d (Devuan), or wherever your init scripts are stored. By the way, I built these starting with the template at [[https://github.com/fhd/init-script-template|fhd's Github]].
 +
 +Create the file /etc/init.d/hbbs with the following content to control the signaling server via SysV Init
 +
 +<code bash hbbs>
 +#!/bin/sh
 +### BEGIN INIT INFO
 +# Provides:          hbbs
 +# Required-Start:    $remote_fs $syslog
 +# Required-Stop:     $remote_fs $syslog
 +# Default-Start:     2 3 4 5
 +# Default-Stop:      0 1 6
 +# Short-Description: Rust Signaling Server
 +# Description:       This provides the definition of the signaling server for rust
 +### END INIT INFO
 +
 +dir="/opt/rustdesk"
 +cmd="/opt/rustdesk/hbbs"
 +user="rust"
 +
 +name=`basename $0`
 +pid_file="/var/run/$name.pid"
 +stdout_log="/var/log/rustdesk/$name.log"
 +stderr_log="/var/log/rustdesk/$name.err"
 +
 +get_pid() {
 +    cat "$pid_file"
 +}
 +
 +is_running() {
 +    [ -f "$pid_file" ] && ps -p `get_pid` > /dev/null 2>&1
 +}
 +
 +case "$1" in
 +    start)
 +    if is_running; then
 +        echo "Already started"
 +    else
 +        echo "Starting $name"
 +        cd "$dir"
 +        if [ -z "$user" ]; then
 +            sudo $cmd >> "$stdout_log" 2>> "$stderr_log" &
 +        else
 +            sudo -u "$user" $cmd >> "$stdout_log" 2>> "$stderr_log" &
 +        fi
 +        echo $! > "$pid_file"
 +        if ! is_running; then
 +            echo "Unable to start, see $stdout_log and $stderr_log"
 +            exit 1
 +        fi
 +    fi
 +    ;;
 +    stop)
 +    if is_running; then
 +        echo -n "Stopping $name.."
 +        kill `get_pid`
 +        for i in 1 2 3 4 5 6 7 8 9 10
 +        # for i in `seq 10`
 +        do
 +            if ! is_running; then
 +                break
 +            fi
 +
 +            echo -n "."
 +            sleep 1
 +        done
 +        echo
 +
 +        if is_running; then
 +            echo "Not stopped; may still be shutting down or shutdown may have failed"
 +            exit 1
 +        else
 +            echo "Stopped"
 +            if [ -f "$pid_file" ]; then
 +                rm "$pid_file"
 +            fi
 +        fi
 +    else
 +        echo "Not running"
 +    fi
 +    ;;
 +    restart)
 +    $0 stop
 +    if is_running; then
 +        echo "Unable to stop, will not attempt to start"
 +        exit 1
 +    fi
 +    $0 start
 +    ;;
 +    status)
 +    if is_running; then
 +        echo "Running"
 +    else
 +        echo "Stopped"
 +        exit 1
 +    fi
 +    ;;
 +    *)
 +    echo "Usage: $0 {start|stop|restart|status}"
 +    exit 1
 +    ;;
 +esac
 +
 +exit 0
 +
 +</code>
 +
 +Create the file /etc/init.d/hbbr with the following content to control the relay server via SysV Init
 +
 +
 +<code bash hbbr>
 +#!/bin/sh
 +### BEGIN INIT INFO
 +# Provides:          hbbr
 +# Required-Start:    $remote_fs $syslog
 +# Required-Stop:     $remote_fs $syslog
 +# Default-Start:     2 3 4 5
 +# Default-Stop:      0 1 6
 +# Short-Description: Rust Relay Server
 +# Description:       This provides the definition of the relay server for rust
 +### END INIT INFO
 +
 +dir="/opt/rustdesk"
 +cmd="/opt/rustdesk/hbbr"
 +user="rust"
 +
 +name=`basename $0`
 +pid_file="/var/run/$name.pid"
 +stdout_log="/var/log/rustdesk/$name.log"
 +stderr_log="/var/log/rustdesk/$name.err"
 +
 +get_pid() {
 +    cat "$pid_file"
 +}
 +
 +is_running() {
 +    [ -f "$pid_file" ] && ps -p `get_pid` > /dev/null 2>&1
 +}
 +
 +case "$1" in
 +    start)
 +    if is_running; then
 +        echo "Already started"
 +    else
 +        echo "Starting $name"
 +        cd "$dir"
 +        if [ -z "$user" ]; then
 +            sudo $cmd >> "$stdout_log" 2>> "$stderr_log" &
 +        else
 +            sudo -u "$user" $cmd >> "$stdout_log" 2>> "$stderr_log" &
 +        fi
 +        echo $! > "$pid_file"
 +        if ! is_running; then
 +            echo "Unable to start, see $stdout_log and $stderr_log"
 +            exit 1
 +        fi
 +    fi
 +    ;;
 +    stop)
 +    if is_running; then
 +        echo -n "Stopping $name.."
 +        kill `get_pid`
 +        for i in 1 2 3 4 5 6 7 8 9 10
 +        # for i in `seq 10`
 +        do
 +            if ! is_running; then
 +                break
 +            fi
 +
 +            echo -n "."
 +            sleep 1
 +        done
 +        echo
 +
 +        if is_running; then
 +            echo "Not stopped; may still be shutting down or shutdown may have failed"
 +            exit 1
 +        else
 +            echo "Stopped"
 +            if [ -f "$pid_file" ]; then
 +                rm "$pid_file"
 +            fi
 +        fi
 +    else
 +        echo "Not running"
 +    fi
 +    ;;
 +    restart)
 +    $0 stop
 +    if is_running; then
 +        echo "Unable to stop, will not attempt to start"
 +        exit 1
 +    fi
 +    $0 start
 +    ;;
 +    status)
 +    if is_running; then
 +        echo "Running"
 +    else
 +        echo "Stopped"
 +        exit 1
 +    fi
 +    ;;
 +    *)
 +    echo "Usage: $0 {start|stop|restart|status}"
 +    exit 1
 +    ;;
 +esac
 +
 +exit 0
 +
 +</code>
 +
 +Now (we're almost done), run the following commands to start the both servers up.
 +
 +<code bash>
 +chmod 755 /etc/init.d/hbbr
 +chmod 755 /etc/init.d/hbbs
 +# test hbbs
 +/etc/init.d/hbbs start
 +# test hbbr
 +/etc/init.d/hbbr start
 +# if both worked correctly, run the following command to automatically start at boot
 +update-rc.d hbbs defaults
 +update-rc.d hbbr defaults
 +</code>
 +
 +If you made it through the last step with no errors, you should now be able to access the server from one of the clients.
 +
 +===== Set automatic log rotate =====
 +
 +Your logs can get quite large, so it is best to rotate them occassional. Devuan uses the logrotate script to do this for, and it is fairly simple to add a new definition in /etc/logrotate.d for the next pass.
 +
 +Following command will create the definition. It will rotate the hbbr/hbbs logs daily, keeping two weeks of logs. All logs except for the current one and the previous one will be compressed.
 +
 +This is just one command. Just copy and paste it anywhere into the server.
 +
 +<code bash rotatelogs>
 +cat << EOF > /etc/logrotate.d/rustdesk
 +/var/log/rustdesk/*.log /var/log/rustdesk/*.err {
 +   daily
 +   rotate 14
 +   compress
 +   delaycompress
 +   create 640 rust rust
 +   postrotate
 +      service hbbr restart > /dev/null
 +      service hbbs restart > /dev/null
 +   endscript
 +   sharedscripts
 +   missingok
 +   notifempty
 +}
 +EOF
 +</code>
 +
 +
 +===== Links =====
 +
 +  * [[https://github.com/fhd/init-script-template|Template for creating SysV init scripts]]
 +  * [[https://github.com/techahold/rustdeskinstall/blob/master/install.sh|Excellent install script for open source RustDesk Server on Linux which uses SystemD]]
 +  * [[https://rustdesk.com/docs/en/self-host/rustdesk-server-oss/install/|Documentation from RustDesk for installing the Open Source server]]
 +  * [[https://raw.githubusercontent.com/dinger1986/rustdeskinstall/master/|Installer Scripts for RustDesk Client]]
 +  * [[https://rustdesk.com/docs/en/self-host/client-deployment/|Several customized installer scripts for RustDesk Client]]
software/rust/server_devuan.1758201419.txt.gz · Last modified: 2025/09/18 08:16 by rodolico