Guía paso a paso

Cómo instalar y configurar el
SVXLink TETRA Dashboard

Prepara el entorno, ajusta SVXLink y despliega el panel web para tu nodo HamTETRA en una Raspberry Pi en pocos minutos.

SVXLink TETRA Dashboard es un panel web desarrollado por amateurradionet.com,
basado en el trabajo de KC1AWV e EA2CQ Iñigo, que muestra el estado en tiempo real de los nodos
de la red HamTETRA gestionados con SVXLink. Estas instrucciones asumen una instalación
de SVXLink para TETRA ya operativa en una Raspberry Pi.

SVXLink TETRA Dashboard preview


1

Instalar PHP y Apache2

El dashboard necesita un servidor web Apache con soporte PHP para funcionar. Ejecuta el siguiente comando en tu Raspberry Pi para instalar ambos paquetes de una sola vez:

bash
sudo apt -y install php php-common apache2

2

Cambiar el usuario de Apache2

Apache2 debe ejecutarse con el usuario svxlink para poder acceder a los ficheros de estado generados por SVXLink. Edita el fichero de variables de entorno:

bash
sudo nano /etc/apache2/envvars

Localiza estas dos líneas y sustitúyelas:

antes
# Líneas originales a reemplazar
export APACHE_RUN_USER=www-data
export APACHE_RUN_GROUP=www-data
después
export APACHE_RUN_USER=svxlink
export APACHE_RUN_GROUP=svxlink

Guarda el fichero y reinicia Apache2:

bash
sudo service apache2 restart

3

Eliminar la opción PrivateTmp de Apache2

Por defecto, Apache2 usa un directorio /tmp privado que impide el acceso al socket de SVXLink. Copia el servicio al directorio de systemd local y edítalo:

bash
sudo cp /lib/systemd/system/apache2.service /etc/systemd/system/
sudo nano /etc/systemd/system/apache2.service

Cambia la siguiente línea dentro del fichero:

antes → después
PrivateTmp=true  →  cambia a:
PrivateTmp=false

Guarda y reinicia la Raspberry Pi para aplicar el cambio:

bash
sudo reboot

4

Habilitar comandos remotos DTMF en SVXLink

El dashboard necesita poder enviar comandos DTMF a SVXLink mediante un puerto serie virtual. Edita la configuración principal de SVXLink:

bash
sudo nano /etc/svxlink/svxlink.conf

Localiza el bloque [TetraLogic] y añade la línea indicada justo después de las directivas de RX y TX:

svxlink.conf
# Bloque existente — no modificar estas líneas
[TetraLogic]
TYPE=Tetra
RX=Rx1
TX=Tx1

# Añadir: activa comandos DTMF por consola virtual
DTMF_CTRL_PTY=/tmp/svxlink_dtmf

Guarda y reinicia el servicio SVXLink:

bash
sudo service svxlink restart

5

Añadir svxlink al grupo sudoers

El usuario svxlink —con el que corre Apache2— necesita ejecutar ciertos comandos del sistema desde el dashboard. Primero, añádelo al grupo sudo:

bash
sudo usermod -aG sudo svxlink

A continuación, edita el fichero sudoers con visudo (nunca con un editor directo) y añade las reglas sin contraseña al final del fichero:

bash
sudo visudo
sudoers — añadir al final
# Comandos que svxlink puede ejecutar sin contraseña
svxlink ALL=NOPASSWD: /usr/sbin/service
svxlink ALL=NOPASSWD: /bin/cp
svxlink ALL=NOPASSWD: /bin/chown
svxlink ALL=NOPASSWD: /bin/chmod
svxlink ALL=NOPASSWD: /bin/systemctl
⚠️ Seguridad: limitar los comandos a los estrictamente necesarios reduce la superficie de ataque. No uses NOPASSWD: ALL.

6

Descargar los archivos del dashboard

Navega a la raíz del servidor web, elimina la página de bienvenida por defecto de Apache2 y copia el dashboard directamente en esa carpeta:

bash
cd /var/www/html
sudo rm index.html
unzip svxlink_tetra_dahsboard.zip

7

Personalizar config.php Opcional

El fichero de configuración permite adaptar el dashboard a tu nodo: nombre del repetidor, call sign, colores, zona horaria, etc. Edítalo según tus preferencias:

bash
cd /var/www/html/config
nano config.php
💡 Consejo: si actualizas el dashboard en el futuro, comprueba si config.php ha cambiado para no sobreescribir tu configuración personalizada.

8

Acceder al dashboard

Abre un navegador y escribe la dirección IP local de tu Raspberry Pi. Si Apache2 y SVXLink están funcionando correctamente, verás el dashboard cargado con la información de tu nodo en tiempo real.

bash
http://192.168.1.XX   # sustituye por la IP de tu Pi
💡 IP desconocida: puedes consultarla en tu router o ejecutando hostname -I en la terminal de la Raspberry Pi.

¡Dashboard operativo!

El SVXLink TETRA Dashboard está instalado y mostrando el estado de tu nodo HamTETRA.
Ante cualquier problema, revisa los logs de Apache2 con sudo journalctl -u apache2 -f