XLX Debian Installer

This project is derived from the one initially created by N5AMD that facilitates the installation process of the XLX reflector developed by LX3JL. What this script does is automate as many processes as possible so that the installation of the reflector and its respective dashboard are executed with just a few commands and with minimal user intervention. As previously mentioned, in addition to the reflector, it also installs a dashboard so that you can monitor the activity in the reflector in real time. After installing this you will have a public D-Star/DMR/YSF XLX Reflector.

The original projects can be found at the following links:

• Official LX3JL refletor project and install instructions, HERE.
• N5AMD installation script project basis, HERE

At the start of 2020 a new version of XLX was released that allows for native C4FM connections. This means it's even simpler to run a multi-mode reflector. XLX now natively supports D-Star, C4FM and DMR modes. C4FM and DMR do not require any transcoding hardware (AMBE) to work together. but if you plan on using D-Star with any of the other modes you will need hardware AMBE chips, for an XLX DStar Reflector only this is not necessary. This script installs version 2.5.3 of the XLX reflector and version 2.4.2 of the dashboard, it has been tested and works perfectly on Debian 10, 11 and 12 and their derivatives, such as RaspiOS for Raspberry Pi and does not require many hardware resources, and can be easily run on a Raspberry Pi Zero or similar.

Installation requirements:

1. A fresh Debian based computer ready and up to date;
2. A stable internet connection with a fixed public IP;
3. Ability to redirect some ports to the server;
4. Have a FQDN to dashboard, like xlx300.net;
5. A free 3 digit XLX sufix, both numbers and letters can be used;
6. An administrator e-mail address;
7. A Gateway callsign;
8. Number of active modules;
9. YSF UDP port;
10. Wires-X GW frequency.

cd
sudo git clone https://github.com/PU5KOD/xlxd_installer.git
cd xlxd_installer
sudo bash xlxdinstaller.sh

How to find what reflectors are available:

Find a current active reflector dashboard here and you will see the gaps in reflector numbers in the list, those reflector numbers not listed are available.

To interact with xlxd after installation:

sudo systemctl start|stop|status|restart xlxd.service
journalctl -u xlxd.service -f -n 50

Location of installation files:

• Installs to /xlxd
• Installation files in /usr/src/xlxd/
• Logs are in /var/log/messages and 'systemctl status xlxd'
• Main config file is /var/www/html/pgs/config.inc.php
• Dashboard files ars in /var/www/html/xlxd/

Firewall Settings:

XLX Server requires the following ports to be open and forwarded properly for in- and outgoing network traffic:

• (*) TCP port 80 (http)
• (*) TCP port 443 (https)
• TCP port 8080 (RepNet) optional
• (*) UDP port 10001 (json interface XLX Core)
• (*) UDP port 10002 (XLX interlink)
• TCP port 22 (ssh)
• TCP port 10022 (Remote) optional
• UDP port 42000 (YSF protocol)
• (*) UDP port 30001 (DExtra protocol)
• (*) UPD port 20001 (DPlus protocol)
• (*) UDP port 30051 (DCS protocol)
• UDP port 8880 (DMR+ DMO mode)
• (*) UDP port 62030 (MMDVM protocol)
• UDP port 10100 (AMBE controller port)
• UDP port 10101 - 10199 (AMBE transcoding port)
• UDP port 12345 - 12346 (Icom Terminal presence and request port)
• UDP port 40000 (Terminal dv port)
• UDP port 21110 (Yaesu IMRS protocol)

Ports marked with * are mandatory.