This project simplifies the installation of XLX reflectors with minimal user intervention. Developed by Daniel K. (PU5KOD), this installer automates the setup of the XLX reflector created by LX3JL and includes a customized dark theme dashboard. The goal is to make deploying an XLX reflector easy, reliable, and maintainable!

Upon completion, you'll have a fully functional public D-Star/YSF/DMR XLX reflector with monitoring dashboard! 🎉

• ✅ No AMBE hardware needed for C4FM and DMR interoperability (since early 2020)
• ✅ Complete systemd service integration replacing legacy init.d scripts
• ✅ Dark theme dashboard with improvements and modern UI
• ✅ Lightweight - it ever runs on Raspberry Pi Zero!
• ✅ Optional Echo Test (Parrot) service to audio tests
• ✅ Compatible with Debian 10+ (13 recommended), Ubuntu, RaspiOS, Armbian, etc...
• ✅ Full uninstall support
• ✅ Built-in User Manager for whitelist, dashboard access and RadioID database

Note: D-Star integration with other modes still requires AMBE chips. For D-Star-only or YSF/DMR reflectors, no additional hardware is needed.

The included dashboard is a dark-theme fork with major improvements:

• Real-time multi-TX module detection with pulsing highlight animation and live TX timers
• Live duration counter for connected stations, updating every second without page reload
• Responsive layout for desktop and mobile
• 30‑day activity history and module activity chart (via Chart.js, independent 60-second refresh)
• SQLite operator database (call, name, city) displayed in Recent Activity and Connected Stations tabs
• Filter-aware auto-refresh — pauses when a callsign or module filter is active
• Browser tab badge showing connected station count and active TX callsign
• Hidden tabs support and others via config.inc.php

The installer provides native systemd services, replacing original XLXD init.d behavior:

• xlxd.service
• xlx_log.service
• update_XLX_db.service (update timers)
• xlxecho.service (if Echo Test is enabled)

This brings better reliability, logging, restart behavior, and dependency control.

Before installation, ensure you have:

• Debian-based system or VPS with latest updates
• Stable internet connection with fixed public IP
• Firewall management capabilities
• FQDN for dashboard (e.g., xlxbra.net)
• Unique 3-digit XLX ID (check availability here)

Visit any active reflector dashboard to see which XLX suffixes are in use. Any unlisted suffix is available!

Before running the installer, ensure all required ports are open and forwarded (see Firewall Configuration).

Execute the commands from the Quick Start section above.

The installer will request the following information:

The installation proceeds automatically. Once complete, your reflector will be operational and ready to accept connections!

# Update system sudo apt update && sudo apt full-upgrade -y # Install prerequisites sudo apt install git -y # Clone repository cd /usr/src/ sudo git clone https://github.com/PU5KOD/XLX_Installer.git # Run installer cd XLX_Installer/ && sudo chmod +x *.sh sudo ./installer.sh

# Start the reflector sudo systemctl start xlxd.service # Stop the reflector sudo systemctl stop xlxd.service # Restart the reflector sudo systemctl restart xlxd.service # Check status sudo systemctl status xlxd.service

# Watch live logs sudo tail -f /var/log/xlx.log

The installer includes reflector_user_manager.sh, a unified terminal tool for all user administration tasks. Instead of running separate scripts, everything is available from a single two-level interactive menu.

sudo /xlxd/users_db/reflector_user_manager.sh

Main menu ├── 1) Database (RadioID) │ ├── 1) Add / Edit record │ ├── 2) Delete record │ ├── 3) List records by Callsign │ ├── 4) Search records (filter) │ ├── 5) Create / Update SQL database │ └── X) Back └── 2) Access Control ├── 1) Add user (whitelist + dashboard) ├── 2) Reset password (dashboard) ├── 3) Remove user (whitelist + dashboard) ├── 4) Look up user (whitelist + dashboard) ├── 5) List pending (password not yet changed) ├── 6) List whitelist (all callsigns) └── X) Back 

For full documentation see REFLECTOR_USER_MANAGER.md.

To list your reflector on YSF hosts:

1. Visit dvref.com
2. Follow the registration instructions

If you skipped automatic SSL during installation:

1. Visit the Certbot website
2. Follow the simple instructions
3. Ensure TCP ports 80 and 443 are open and forwarded

To remove all traces of the installation:

cd /usr/src/xlx_installer sudo ./uninstaller.sh

This removes:

• systemd services
• dashboard
• reflector core
• config files
• Apache integration
• cron/timers
• logs
• directories

No leftovers.

If you encounter issues or have questions:

• 📧 Contact the maintainer: PU5KOD
• 🐛 Open an issue on GitHub
• 💬 Join the amateur radio community discussions

This project is open source and available for use by the amateur radio community. MIT License – free to use and modify.