Log elettronico QSO con Cloudlog: sostituire i registri cartacei

Ogni radioamatore che si rispetti tiene traccia dei suoi QSO (contatti). Il quaderno cartaceo va bene per iniziare, ma dopo 1000 contatti vuoi statistiche, ricerca full-text, mappe DXCC. Cloudlog e' la soluzione self-hosted matura.

1. Cosa fa Cloudlog

• Registro completo QSO (frequency, mode, rst, name, gridsquare, ecc.)
• Statistiche: DXCC worked/confirmed, WAS, WAZ, IOTA, SOTA
• Mappa mondiale con i tuoi contatti pinnati
• Import/export ADIF (formato standard interoperabile)
• Upload automatico a LoTW, eQSL, QRZ.com, Clublog
• API REST per integrazione con logger real-time (JS8Call, WSJT-X, N1MM)
• Multi-station (piu' operatori sullo stesso database)

2. Requisiti

• PHP 8.0+ con extension mysqli, curl, gd, xml
• MySQL/MariaDB 5.7+
• Apache o Nginx
• ~100 MB di spazio + spazio per il DB (~10 MB ogni 10.000 QSO)
• Ideale: Raspberry Pi 4/5, VPS 5€/mese, oppure NAS con Docker

3. Installazione su Ubuntu Server

sudo apt install apache2 mysql-server php php-mysqli php-curl php-gd php-xml php-mbstring git unzip
cd /var/www/html
sudo git clone https://github.com/magicbug/Cloudlog.git
sudo chown -R www-data:www-data Cloudlog
sudo chmod -R 755 Cloudlog

4. Database

sudo mysql
CREATE DATABASE cloudlog CHARACTER SET utf8mb4;
CREATE USER 'cloudlog'@'localhost' IDENTIFIED BY 'PasswordForte2026';
GRANT ALL ON cloudlog.* TO 'cloudlog'@'localhost';
FLUSH PRIVILEGES;
EXIT;

5. Setup web

Apri http://IP/Cloudlog/install. Inserisci:

• DB host: localhost
• DB name: cloudlog
• DB user: cloudlog
• DB pass: PasswordForte2026
• User admin: crea account con password

Poi Dashboard > Preferences > Station Profile: inserisci callsign, locator (JN53fe), gridsquare, DXCC entity.

6. Aggiungere il primo QSO manualmente

Menu > Add QSO
- Call: IK7ABC
- Freq: 14.220
- Mode: SSB
- RST TX: 59
- RST RX: 59
- Name: Marco
- QTH: Lecce
- Comment: 40m banda aperta oggi

7. Rig control (frequenza+modo automatica)

Se hai una radio HAM moderna con CAT (Yaesu, Icom, Kenwood):

Rigctld (Linux/Mac):
sudo apt install libhamlib-utils
rigctld -m 1035 -r /dev/ttyUSB0 -s 4800

Cloudlog Preferences > Radio > imposta:
- Radio interface: FLRig (o simile)
- URL: http://IP-radio:12345

Ora Cloudlog legge frequenza/modo dalla radio: apri finestra "Live QSO" e i campi si riempiono da soli.

8. Import di log esistenti (ADIF)

Se hai un vecchio log in altro software (Logger32, HRD, N1MM), esportali in ADIF:

Cloudlog > Menu > Import ADIF > Upload file > Match campi

10.000 QSO si importano in ~1 minuto.

9. Upload automatico a LoTW

Se sei registrato su ARRL LoTW:

1. Genera un file .p12 in TQSL
2. Cloudlog Preferences > LoTW > upload del .p12
3. Password del certificato
4. Abilita "Auto upload"

Ogni QSO nuovo viene uploaded su LoTW: pochi giorni dopo il conferma arriva e Cloudlog aggiorna lo status "Confirmed".

10. API per WSJT-X (JS8Call, FT8)

Cloudlog espone un endpoint HTTP che accetta log ADIF: WSJT-X lo puo' chiamare a ogni QSO completato.

WSJT-X > File > Settings > Reporting > UDP Server:
- Enable
- Server: 127.0.0.1
- Port: 2237

# poi installa "wsjtx-udp-to-cloudlog" o "gridtracker"

11. Backup automatico DB

# /etc/cron.daily/cloudlog-backup
#!/bin/bash
DATE=$(date +%Y%m%d)
mysqldump -u cloudlog -pPasswordForte2026 cloudlog | gzip > /backup/cloudlog-$DATE.sql.gz
# retention 90 giorni
find /backup -name "cloudlog-*.sql.gz" -mtime +90 -delete

12. Dashboard e stats

Cloudlog mostra dashboard con:

• Contatti oggi/settimana/mese/anno
• Bande piu' usate
• Modi piu' usati
• Mappa con pins dei paesi contattati
• Trend mensili (grafici)
• DXCC status (worked/confirmed su ogni entita')