ADSBItalia logo
Partecipa alla rete globale ADSBItalia

Collega il tuo feeder ADS-B e MLAT ad ADSBItalia.

ADSBItalia aggrega feed ADS-B e risultati MLAT da stazioni indipendenti in tutto il mondo. Puoi contribuire alla mappa live mantenendo il pieno controllo della tua installazione locale.

Puoi partecipare con Ultrafeeder/Docker, ADSB.im, con un feed Beast compatibile oppure con l’installazione classica tramite script. Tutte le connessioni verso ADSBItalia avvengono in uscita: non serve aprire porte sul router.

Scegli il metodo Controlla il tuo feed Contattaci
Supporto community

Hai problemi con la configurazione?

Chiedi aiuto alla community ADSBItalia su Discord o Telegram. Indica metodo usato, hardware, software, messaggio di errore e log rilevanti. Non condividere mai token, password o dati personali.

Chiedi su Discord Chiedi nella community Telegram

Modalità di partecipazione

ADSBItalia accetta feed ADS-B in formato Beast e, dove possibile, connessioni MLAT dedicate. La scelta più comoda dipende da come è configurata la tua stazione: Docker/Ultrafeeder, ADSB.im, decoder locale classico, readsb, dump1090 o altro software compatibile.

Consigliato Ultrafeeder / Docker

Se usi Ultrafeeder, puoi aggiungere ADSBItalia tra gli outbound feeders senza installare servizi systemd aggiuntivi sul sistema host.

Configura Ultrafeeder
Senza script ADSB.im

Dalla versione ADSB.im v3.0.13, ADSBItalia è già integrata. Basta abilitarla con una spunta nella pagina Data Sharing, senza inserire argomenti manuali.

Configura ADSB.im
Alternativa Installazione classica

Se hai un decoder locale con output Beast disponibile su una porta TCP, puoi usare lo script ADSBItalia per creare i servizi ADS-B e MLAT dedicati.

Usa lo script
Novità ACARS / VDL2 / HFDL / Satcom

Contribuisci con telemetria VHF ACARS, VDL Mode 2, onde corte HFDL o satelliti Inmarsat/Iridium tramite acars_router, dumphfdl o ADSB.im.

Configura ACARS
La pagina “Stato del tuo feed” funziona anche con Ultrafeeder: ADSBItalia verifica le connessioni in arrivo dal tuo IP pubblico verso le porte della rete.

Cosa invii ad ADSBItalia

  • Feed ADS-B Beast verso ADSBItalia sulla porta 31108.
  • Connessione MLAT verso ADSBItalia sulla porta 41113, se configurata.
  • Risultati MLAT locali opzionali su una porta dedicata, se supportati dalla tua configurazione.
  • Nome feeder, coordinate e altitudine corretti per identificare la stazione e migliorare la qualità MLAT.

Porte principali

Beast locale30005
ADS-B ADSBItalia31108
MLAT ADSBItalia41113
Risultati MLAT33106 / libera

La porta Beast locale può essere diversa da 30005. Le porte verso ADSBItalia sono connessioni in uscita dal feeder verso il server.

Metodo consigliato: Ultrafeeder / Docker

Ultrafeeder è indicato se gestisci già la tua stazione ADS-B tramite Docker. In questo caso non devi installare lo script ADSBItalia sul sistema host: aggiungi ADSBItalia alla configurazione outbound del container e riavvii Ultrafeeder.

Prima di modificare

  • Fai una copia del tuo docker-compose.yml o del file .env.
  • Verifica di avere coordinate, altitudine, nome feeder e UUID corretti.
  • Se hai già altri network in ULTRAFEEDER_CONFIG, aggiungi ADSBItalia senza cancellare le righe esistenti.

Esempio configurazione Ultrafeeder

Aggiungi le righe ADSBItalia alla tua variabile ULTRAFEEDER_CONFIG. Mantieni il punto e virgola tra le righe, tranne sull’ultima riga della variabile.

ULTRAFEEDER_CONFIG=
adsb,adsbitalia.it,31108,beast_reduce_plus_out;
mlat,mlat.adsbitalia.it,41113;

Riavvio e controllo

docker compose pull ultrafeeder
docker compose up -d ultrafeeder
docker logs -f ultrafeeder
La riga MLAT richiede solo host e porta del server MLAT. Usa la configurazione mostrata esattamente così. Se hai dubbi, contatta ADSBItalia indicando che usi Ultrafeeder.

Metodo ADSB.im

Dalla versione v3.0.13, ADSBItalia è integrata direttamente nell’interfaccia di ADSB.im. Non è più necessario eseguire script, aprire la sezione Expert o incollare argomenti Ultrafeeder.

Abilita ADSBItalia

  1. Assicurati che ADSB.im sia aggiornato alla versione v3.0.13 o successiva.
  2. Apri l’interfaccia web di ADSB.im e vai nella pagina Data Sharing.
  3. Trova ADSBItalia nell’elenco degli aggregatori.
  4. Metti la spunta su ADSBItalia e salva o applica le modifiche.
Non serve altro: ADSB.im gestisce automaticamente le connessioni ADS-B e MLAT necessarie. Dopo aver applicato la modifica, controlla la pagina “Stato del tuo feed” per verificare che la stazione sia online.

Installazione classica tramite script

Usa questo metodo se hai un decoder ADS-B locale che espone un output Beast su 127.0.0.1 o su un host raggiungibile dalla macchina del feeder.

Installazione rapida

Esegui questo comando sul feeder:

curl -fsSL https://raw.githubusercontent.com/ADSBItalia/Feeding/main/install.sh -o install.sh && bash install.sh

Cosa fa lo script

Lo script verifica la porta Beast locale, installa i pacchetti necessari, prepara l’ambiente dedicato per mlat-client, registra il feeder e crea i servizi systemd locali per inviare ADS-B e MLAT ad ADSBItalia.

Script disponibili

  • install.sh — installazione iniziale del feeder.
  • update.sh — aggiornamento di nome feeder, coordinate e altitudine.
  • uninstall.sh — rimozione dei servizi ADSBItalia e dell’ambiente MLAT dedicato.

Requisiti

  • Ricevitore ADS-B attivo.
  • Feed Beast disponibile localmente oppure configurazione Ultrafeeder/Docker compatibile.
  • Connessione Internet stabile.
  • Possibilità di inviare dati verso ADSBItalia tramite connessione in uscita.
  • Coordinate e altitudine corrette se vuoi contribuire anche a MLAT.

Non è necessario aprire porte sul router. Con installazione classica servono privilegi sudo; con Ultrafeeder basta modificare la configurazione Docker esistente.

Risultati MLAT locali

Quando configurato, il feeder può ricevere i risultati MLAT in locale e riutilizzarli nella propria installazione, per esempio nella mappa locale o in servizi compatibili.

Comandi di gestione

Installazione classica

Stato dei servizi:

sudo systemctl status adsbitalia-feed.service
sudo systemctl status adsbitalia-mlat.service

Log in tempo reale:

sudo journalctl -u adsbitalia-feed.service -f
sudo journalctl -u adsbitalia-mlat.service -f

Ultrafeeder / Docker

docker ps | grep ultrafeeder
docker logs -f ultrafeeder
docker compose logs -f ultrafeeder

Aggiornamento e rimozione

Aggiornare dati installazione classica

Per cambiare nome feeder, coordinate o altitudine:

curl -fsSL https://raw.githubusercontent.com/ADSBItalia/Feeding/main/update.sh -o update.sh && bash update.sh

Rimuovere ADSBItalia

Per rimuovere i servizi ADSBItalia dall’installazione classica:

curl -fsSL https://raw.githubusercontent.com/ADSBItalia/Feeding/main/uninstall.sh | sudo bash

Con Ultrafeeder basta rimuovere le righe ADSBItalia dalla configurazione del container e riavviare Ultrafeeder.

File creati dall’installazione classica

/opt/adsbitalia-mlat                         Ambiente Python dedicato a mlat-client.
/etc/adsbitalia/feeder.conf                 Configurazione del feeder.
/etc/systemd/system/adsbitalia-mlat.service     Servizio systemd MLAT ADSBItalia.
/etc/systemd/system/adsbitalia-feed.service     Servizio systemd ADS-B forwarding ADSBItalia.

Questi file non vengono creati se partecipi tramite Ultrafeeder/Docker senza usare lo script classico.

Risoluzione problemi

Se il feed non risulta online, controlla prima quale metodo stai usando.

Installazione classica

sudo systemctl status adsbitalia-feed.service
sudo systemctl status adsbitalia-mlat.service
sudo journalctl -u adsbitalia-feed.service -n 100 --no-pager
sudo journalctl -u adsbitalia-mlat.service -n 100 --no-pager

Ultrafeeder

docker ps | grep ultrafeeder
docker logs --tail 100 ultrafeeder
docker compose logs --tail 100 ultrafeeder

Verifica anche che il feeder locale stia generando dati ADS-B, che le coordinate siano corrette e che il firewall consenta connessioni in uscita verso ADSBItalia.

Contatta ADSBItalia

Come inviare dati ACARS, VDL-M2, HFDL e Satcom

ADSBItalia dispone di un ACARS & Satcom Router centrale che riceve flussi distinti da stazioni VHF ACARS, VDL Mode 2, HFDL (Onde corte) e Satellitari (Inmarsat/Iridium/JAERO) in tutto il mondo.

Il nostro server arricchisce automaticamente i pacchetti con il calcolo in tempo reale della GroundSpeed (velocità al suolo) e la memoria di quota per i voli oceanici, visualizzandoli in tempo reale sulla mappa live.

Server / Host globale: feed.adsbitalia.it (oppure adsbitalia.it)

Tabella Porte Ingestione Dedicate

Satcom (Inmarsat / Iridium / JAERO)5554JSON (TCP/UDP)
VHF ACARS (131 MHz)5550JSON (TCP/UDP)
VDL Mode 2 (VHF 136 MHz)5555JSON (TCP/UDP)
HFDL (Onde corte 2–30 MHz)5556JSON (TCP/UDP)
BaseStation SBS generico31109SBS (TCP)

Configurazione acars_router (Docker / SDR-Enthusiasts)

Se utilizzi acars_router (SDR-Enthusiasts), inserisci le destinazioni dedicate nelle variabili d'ambiente del tuo docker-compose.yml e riavvia il container:

environment:
  - AR_SEND_UDP_ACARS=feed.adsbitalia.it:5550
  - AR_SEND_UDP_JAERO=feed.adsbitalia.it:5554
  - AR_SEND_UDP_INMARSAT=feed.adsbitalia.it:5554
  - AR_SEND_UDP_IRIDIUM=feed.adsbitalia.it:5554
  - AR_SEND_UDP_VDLM2=feed.adsbitalia.it:5555
  - AR_SEND_UDP_HFDL=feed.adsbitalia.it:5556

Configurazione ADSB.im

Apri il pannello web di ADSB.im, vai al pacchetto attivo HFDL, VDL2, Satcom o ACARS e in Custom Destinations imposta feed.adsbitalia.it (oppure adsbitalia.it) con la relativa porta in formato JSON.

Host: feed.adsbitalia.it
Porte: 5556 (HFDL) | 5555 (VDL2) | 5554 (Satcom/JAERO) | 5550 (VHF ACARS)
Formato: JSON

Decodificatori Standalone da linea di comando

# Inmarsat / Iridium Satcom (JAERO):
Settings -> Audio/Decoding -> ACARS Output -> Host: feed.adsbitalia.it, Port: 5554, Protocol: UDP (JSON)

# VHF ACARS (acarsdec):
acarsdec -j feed.adsbitalia.it:5550

# VDL Mode 2 (dumpvdl2):
dumpvdl2 --output-acars decoded:json:tcp:address=feed.adsbitalia.it,port=5555

# HFDL (dumphfdl):
dumphfdl --output decoded:json:tcp:address=feed.adsbitalia.it,port=5556