Wavelog: il moderno logbook web per radioamatori — configurazione con Docker

Qualsiasi radioamatore che voglia documentare correttamente i propri QSO (contatti radio) ha bisogno di un log. Ma i tempi delle registrazioni scritte a mano sono ormai lontani: i moderni log basati sul web offrono tracciamento DXCC, gestione automatica delle QSL, importazione ed esportazione ADIF e interfacce API per l’integrazione con il software del ricetrasmettitore. Wavelog si è affermato come il principale successore del noto Cloudlog ed è sviluppato attivamente. In questo articolo mostriamo cosa può fare Wavelog, come configurarlo con Docker in pochi minuti e perché anche noi di oeradio.at utilizziamo Wavelog.

Cos’è Wavelog?

Wavelog è un software di logging open source basato sul web per radioamatori. Permette di registrare i QSO tramite browser web da qualsiasi dispositivo con accesso a Internet — che sia dal PC desktop nello shack, da un tablet durante un field day o dallo smartphone durante un’attivazione SOTA. Il software è scritto in PHP e utilizza MySQL o MariaDB come database backend.

L’attuale versione 2.4 (marzo 2026) porta numerosi miglioramenti rispetto al predecessore Cloudlog: prestazioni più veloci, migliore gestione degli errori e un’interfaccia utente modernizzata. Con oltre 19.000 commit e 94 sviluppatori attivi, Wavelog è uno dei progetti open source più attivamente mantenuti nel settore radioamatoriale.

Da Cloudlog a Wavelog: la storia

Wavelog è un fork del collaudato Cloudlog di MM9SQL (ex 2M0SQL). Alla fine del 2023, il core team — composto da LA8AJA, DF2ET, DJ7NT e HB9HIL — ha iniziato lo sviluppo e il 1° febbraio 2024 è stata rilasciata la prima versione ufficiale. L’obiettivo era chiaro: proseguire il concetto di successo di Cloudlog ma con un focus costante su stabilità, usabilità e scalabilità.

Mentre Cloudlog continua ad esistere, la comunità attiva degli sviluppatori si è in gran parte spostata su Wavelog. Le installazioni esistenti di Cloudlog possono essere migrate relativamente facilmente a Wavelog grazie alle strutture di database compatibili.

Le funzionalità principali

Tracciamento DXCC e diplomi

Wavelog offre il tracciamento integrato per DXCC (DX Century Club), WAS (Worked All States), WAZ (Worked All Zones), IOTA (Islands On The Air), SOTA, POTA, WWFF e altri programmi di diplomi. Mappe interattive mostrano a colpo d’occhio quali paesi e zone sono già confermati e dove ci sono ancora lacune. Un filtro per data consente l’analisi per periodi temporali.

Gestione QSL

La gestione QSL in Wavelog supporta sia le tradizionali cartoline QSL cartacee che la conferma elettronica tramite LoTW (Logbook of The World), eQSL, QRZ.com e ClubLog. I caricamenti dei QSO possono avvenire automaticamente in background (cron manager) e lo stato di ogni QSO viene visualizzato chiaramente. Inoltre, è disponibile una funzione integrata di stampa etichette QSL per le cartoline fisiche.

Multi-utente e multi-stazione

Wavelog supporta account multipli con gestione granulare dei permessi — ideale per club e stazioni di gruppo. Ogni utente può gestire più postazioni e passare facilmente dall’una all’altra. Questo permette di mantenere una stazione domestica, una stazione portatile e una stazione da contest separatamente, valutandole centralmente.

Importazione ed esportazione ADIF

L’Amateur Data Interchange Format (ADIF) è lo standard industriale per lo scambio di dati di log tra programmi diversi. Wavelog supporta l’importazione e l’esportazione completa in formato ADIF nonché l’esportazione Cabrillo per le valutazioni dei contest. Ciò semplifica notevolmente la migrazione da altri programmi di logging.

API e integrazione CAT

Wavelog offre un’API REST completa attraverso la quale programmi esterni possono inserire QSO, interrogare dati di log e impostare parametri della stazione. Con WaveLogGate — un’applicazione companion basata su Electron — potete collegare WSJT-X, FLRig e Hamlib (rigctld) direttamente a Wavelog. Frequenza, modo e potenza vengono automaticamente acquisiti dal ricetrasmettitore e i QSO digitali da WSJT-X vengono scritti direttamente nel log.

Altre funzionalità

• Mappe interattive (gridsquare, DXCC, zone CQ)
• Tracciamento satellitare con previsione dei passaggi
• Integrazione calendario contest
• Oltre 40 versioni linguistiche
• Design responsive per uso mobile
• Statistiche e valutazioni integrate
• Connessione DX cluster
• Widget per l’incorporamento nella propria homepage

Configurare Wavelog con Docker: passo dopo passo

Docker è il modo più semplice per mettere in funzione Wavelog. Non dovete configurare manualmente un web server né installare PHP — tutto è già incluso nell’immagine Docker. Di seguito mostriamo la configurazione con Docker Compose.

Prerequisiti

• Un server Linux, NAS (es. Synology) o un Raspberry Pi 4/5
• Docker e Docker Compose installati
• Almeno 1 GB di RAM e 2 GB di spazio libero su disco
• Opzionale: un reverse proxy (es. Nginx Proxy Manager, Traefik o Cloudflare Tunnel) per l’accesso HTTPS

Il docker-compose.yml

Create una nuova directory e inseritevi un file chiamato docker-compose.yml:

version: "3.8"

services:
  wavelog-db:
    image: mariadb:11.3
    container_name: wavelog-db
    restart: unless-stopped
    environment:
      MARIADB_RANDOM_ROOT_PASSWORD: "yes"
      MARIADB_DATABASE: wavelog
      MARIADB_USER: wavelog
      MARIADB_PASSWORD: la_vostra_password_sicura
    volumes:
      - wavelog-dbdata:/var/lib/mysql

  wavelog-main:
    image: ghcr.io/wavelog/wavelog:latest
    container_name: wavelog-main
    restart: unless-stopped
    depends_on:
      - wavelog-db
    ports:
      - "8086:80"
    environment:
      CI_ENV: docker
    volumes:
      - wavelog-config:/var/www/html/application/config/docker
      - wavelog-uploads:/var/www/html/uploads
      - wavelog-userdata:/var/www/html/userdata

volumes:
  wavelog-dbdata:
  wavelog-config:
  wavelog-uploads:
  wavelog-userdata:

Importante: Sostituite la_vostra_password_sicura con una password robusta. La password root viene generata casualmente da MariaDB (MARIADB_RANDOM_ROOT_PASSWORD), il che aumenta la sicurezza.

Avvio dei container

docker compose up -d

Dopo l’avvio, entrambi i container sono attivi: il database MariaDB e l’applicazione Wavelog. Wavelog è ora accessibile all’indirizzo http://vostro-server:8086.

Configurazione iniziale tramite il wizard di installazione

Al primo accesso a Wavelog nel browser, si avvia automaticamente il wizard di installazione. Qui inserite i dati di connessione al database:

• Database Host: wavelog-db (il nome del container del servizio database)
• Database Name: wavelog
• Database User: wavelog
• Database Password: la vostra password scelta
• Table Prefix: può essere lasciato al valore predefinito

Successivamente create il vostro account amministratore e configurate i parametri base della stazione: nominativo, locator (gridsquare), entità DXCC e modo predefinito.

WaveLogGate: il ponte verso il ricetrasmettitore

Per il collegamento diretto del ricetrasmettitore a Wavelog esiste WaveLogGate — un’applicazione desktop che funge da ponte tra hardware e log web. WaveLogGate supporta:

• WSJT-X / JTDX: Logging automatico dei QSO FT8/FT4 direttamente in Wavelog
• FLRig: Trasferimento di frequenza e modo dal ricetrasmettitore
• Hamlib / rigctld: Controllo CAT universale per praticamente qualsiasi ricetrasmettitore
• FlexRadio SmartSDR: Integrazione diretta tramite il protocollo SmartSDR

Confronto con programmi di logging alternativi

Wavelog non è l’unico programma di logging — ma ha chiari punti di forza rispetto alle alternative:

Log4OM (Windows)

Log4OM è un potente programma desktop Windows con gestione completa dei diplomi e integrazione CAT. Il più grande svantaggio: funziona solo su Windows e non è basato sul web. Per chi vuole registrare da più dispositivi o in mobilità, Wavelog è la scelta migliore.

HAMRS

HAMRS è un’app di logging moderna e multipiattaforma, particolarmente popolare tra gli attivatori POTA. Tuttavia mancano funzionalità avanzate come il tracciamento DXCC, il supporto multi-utente e l’ampia gamma di integrazioni online che Wavelog offre.

N1MM Logger+ (Windows)

N1MM Logger+ è lo standard de facto per il logging dei contest su Windows. Imbattibile nei contest, ma sovradimensionato per l’uso quotidiano del log e funziona solo su Windows. Wavelog lo complementa perfettamente: i log dei contest possono essere importati via Cabrillo o ADIF e gestiti centralmente in Wavelog.

Perché il logging basato sul web è il futuro

I vantaggi di un log basato sul web sono evidenti: accesso da ovunque, nessuna installazione necessaria sul dispositivo finale, indipendente dalla piattaforma (Windows, macOS, Linux, iOS, Android), backup automatici sul server e capacità multi-utente per club e gruppi. La combinazione di deployment Docker e interfaccia web rende Wavelog particolarmente attraente.

Wavelog su oeradio.at

Anche noi di oeradio.at gestiamo la nostra istanza Wavelog su wavelog.oeradio.at. Funziona come container Docker sul nostro Synology NAS, protetto da un tunnel Cloudflare con crittografia HTTPS. La configurazione è stata completata in meno di 30 minuti.

La nostra esperienza dopo diversi mesi di funzionamento: Wavelog funziona stabilmente, i caricamenti automatici dei QSO su LoTW e eQSL funzionano in modo affidabile e l’uso mobile tramite l’interfaccia web responsive si è dimostrato particolarmente utile durante le attivazioni portatili.

Articoli correlati su oeradio.at

Wavelog gioca un ruolo centrale in molte aree della radioamatoriale. Ecco gli articoli correlati su oeradio.at:

• Wavelog – il registro online per la radio portatile – il nostro primo articolo su Wavelog con focus sulle attivazioni SOTA/POTA
• DXCC, WAZ, WPX: i grandi diplomi spiegati – i programmi di diplomi che Wavelog traccia automaticamente
• SOTA in Austria: operare da cima a cima – operazioni portatili con Wavelog come log
• POTA in Austria: dai parchi e riserve naturali – registrare le attivazioni nei parchi direttamente in Wavelog
• WWFF Austria: attivazioni Flora & Fauna – utilizzare il tracciamento WWFF in Wavelog
• FT2 e modi WSJT-X – i modi digitali registrati direttamente in Wavelog tramite WaveLogGate
• Contest per principianti – importare i log dei contest via Cabrillo/ADIF in Wavelog

Fonti e link utili

• Wavelog – Sito ufficiale
• Documentazione Wavelog
• Wavelog su GitHub (Licenza MIT)
• WaveLogGate su GitHub – App companion per integrazione CAT
• Istanza demo Wavelog (Login: demo/demo)
• Traduzioni Wavelog (Weblate) – disponibile in oltre 30 lingue
• Guida installazione Docker
• wavelog.oeradio.at – la nostra istanza Wavelog

Conclusione

Wavelog è attualmente il miglior log basato sul web per radioamatori. La combinazione di funzionalità complete, sviluppo attivo, supporto Docker e una comunità disponibile lo rendono la scelta numero uno per chiunque voglia gestire i propri QSO in modo moderno e a prova di futuro. Provatelo!

73 – la redazione di oeradio.at

Nota di trasparenza

Questo articolo è stato ricercato e scritto con il supporto dell’IA (Claude, Anthropic). Tutti i contenuti sono stati revisionati dalla redazione.