How to install a YSFReflector

The following howto quickly describes the installation and configuration of a YSFReflector-system

Automatic Installation

If you are using a Debian Linux distribution, you could give the following install-script a try: download (right click and install or download via wget on console). After dowanloading the file to your user-directory, be sure to have git and build-essential packages installed on your system. After all just run it with


You would be asked for the name and the description of your reflector and then all would be installed automatically. You just have to start the reflector running following command:

sudo /etc/init.d/ start

Manual Installation

First of all you'll need to get a copy of the sources. This is recommended to do with git as following:

git clone

This copies the actual sources of the whole YSFClients-Project into a folder "YSFClients". Within this directory you'll find a folder "YSFReflector". cd into it and simply do

make clean all

A minute later the compile-process is done and you got an executable file "YSFReflector".

Within the directory you also got a YSFReflector.ini that you have to customize to your own needs. Fill in there following:

Name=Your Reflector's name
Description=Your Reflector's description

There is also a line


that forces the reflector-executable to run as a deamon after startup. For this you'll need to setup a user "mmdvm" on your linux-system. This can be done with:

sudo groupadd mmdvm
sudo useradd mmdvm -g mmdvm -s /sbin/nologin

Now make shure that the user mmdvm has write permissions on the log-directory given in the ini-file. You can do this with

sudo chown mmdvm /var/log/YSFReflector

if the log-directory would be /var/log/YSFReflector

As a last instance of installation, you may want to have the services started automatically at bootup of your server. Therefore you'll need a startup-script. Mine is


and has following content:

# Provides:             YSFReflector
# Required-Start:       $all
# Required-Stop:        
# Default-Start:        2 3 4 5
# Default-Stop:         0 1 6
# Short-Description:    Example startscript YSFReflector

## Fill in name of program here.

start() {
      if [ -e $PIDFILE ]; then
          ## Program is running, exit with error.
          echo "Error! $PROG is currently running!" 1>&2
          exit 1
          cd $PROG_PATH
          ./$PROG $PROG_ARGS
          echo "$PROG started"
          touch $PIDFILE

stop() {
      if [ -e $PIDFILE ]; then
          ## Program is running, so stop it
         echo "$PROG is running"
         rm -f $PIDFILE
         killall $PROG
         echo "$PROG stopped"
          ## Program is not running, exit with error.
          echo "Error! $PROG not started!" 1>&2
          exit 1

## Check to see if we are running as root first.
## Found at
if [ "$(id -u)" != "0" ]; then
      echo "This script must be run as root" 1>&2
      exit 1

case "$1" in
          exit 0
          exit 0
          sleep 5
          exit 0
          echo "Usage: $0 {start|stop|reload}" 1>&2
          exit 1
exit 0
### END

After creating the script, make it executeable with following command:

sudo chmod +x /etc/init.d/

As you can see on top of the script, my binary is located in /usr/local/bin (where I copied it after compile) and my YSFReflector.ini is in /etc

Do it similar to be in standard.

To enable the service simply call

sudo chkconfig on

Then all would be starting on boot-time.

Hope you could follow all steps. It is recommended to do these as root :-)

One word for final: Every (system-relevant) changes you make (for example name or description) are updated automatically in the registration-database by polling-mechanism each 5 minutes. If you want to change hostname/ip-address or port-number, you can do this in the self-service after logging in.


Alltough running a YSFReflector using the installation-howto above would be very easy, there could be some problems getting it online.

If you have trouble finding your reflector online after 20 minutes of time after starting it, there could be some problems to check:

Alternative Installation

Since middle of march there is a python version of the YSFReflector available at github. I would encourage you to try this software. It is working also stable and is also rock solid in high-load-situations (up to 1000 clients no problems). If you have questions to this, feel free to contact the developer.

You like the quality this service is running? Do you want to donate? With your help, the service could be continued on an easier financial way. Use this:
YSFReflector-Registry © 2016-2024 by DG9VH | Impressum | Datenschutzerklärung | Server IP: