FLARM

Why Feed FLARM Data?

Just like feeding ADS-B, sharing FLARM data with OpenSky supports open aviation research and the public good. FLARM adds coverage of gliders, helicopters and other light aircraft that may not broadcast ADS-B, helping researchers understand traffic closer to the ground. Your receiver contributes to a shared historical dataset for studying low-altitude airspace use, collision risk, GNSS signal quality and soaring conditions.

Our paper OpenSky Report 2023: Low Altitude Traffic Awareness for Light Aircraft with FLARM explains the dataset and its research applications. See our Social Impact page for examples of how OpenSky data supports science and civil society.

OpenSky Network supports FLARM data collection in addition to ADS-B and Mode-S for research purposes. To contribute your FLARM data, you need an OGN receiver. If you already have one set up, sharing your data is straightforward. If not, you will need to install and configure an OGN receiver before proceeding. Start with OGN's hardware and software guide and receiver configuration guide.

The OpenSky feed sends raw demodulated messages to our FLARM collector. All messages received through this feed are stored in our Trino database for research. The feed is separate from OGN's APRS feed, so you can keep contributing to OGN while also sharing with OpenSky.

Step 1: Configure Your OGN Receiver to Feed FLARM Data

Edit the receiver configuration file used by ogn-rf and ogn-decode. Its name and location depend on your installation; the table below covers common Raspberry Pi setups. These locations follow the linked projects' published scripts and documentation. For a different version or a custom installation, check the configuration path shown on your receiver's local status page or in its service definition.

Receiver configuration locations and persistent settings for common OGN installations.
Installation Where to Find the Receiver Configuration Where to Keep Your OpenSky Setting
Sébastien Chaumontet's image /home/pi/rtlsdr-ogn.conf, generated from the basic settings in /boot/OGN-receiver.conf. Copy the complete working receiver configuration to /boot/rtlsdr-ogn.conf and add MergeServer there. The image copies this full override into place at boot. Keep ReceiverName set in /boot/OGN-receiver.conf.
Konstantin Gründger's image /home/ogn/rtlsdr-ogn.conf, as documented on OGN's downloads page. Add MergeServer to that receiver file. Follow the image's procedure for saving changes on its read-only filesystem.
Peter Creyghton's image / ogn-install /etc/ogn.conf in the published installer. Basic settings are in /boot/OGN-receiver.conf. The service regenerates /etc/ogn.conf at startup. Add MergeServer to the Demodulator block in its installed generator, /home/pi/rtlsdr-ogn/OGN-receiver-config-manager2, and save the change using the image's procedure. Confirm the active receiver file in /etc/rtlsdr-ogn.conf.
VirusPilot's native installer /home/pi/rtlsdr-ogn/Template.conf for the standard installer. Add MergeServer to that file, then restart the rtlsdr-ogn service. It is the active receiver configuration despite its name; the repository copy under /home/pi/ogn-pi34/ is the install template.
VirusPilot's Docker setup config.vars holds basic settings; the collector setting is in compose.yaml in your docker-ogn checkout. The generated receiver file is /app/rtlsdr-ogn/Template.conf inside the container. In compose.yaml, uncomment MERGE_SERVER=flarm-collector.opensky-network.org:20002 under environment, then run docker compose up -d from that directory to recreate the container with the updated setting. For a custom mounted configuration, edit the persistent host file instead.
Manual installation on Raspberry Pi or Linux The .conf file passed to ogn-rf and ogn-decode. Its location and filename are chosen during setup; it may be named after your station. Edit that receiver file or its persistent generator. Check your systemd service or /etc/rtlsdr-ogn.conf to identify the file actually used.

On installations using the traditional OGN service wrapper, /etc/rtlsdr-ogn.conf lists the programs and their receiver configuration files; put MergeServer in the receiver configuration, not in that service list. The named images and installers are community projects; check their supported Raspberry Pi and operating-system versions before choosing one for a new installation.

Add or update MergeServer inside the existing Demodulator section of the receiver configuration, or add the section if it is absent:

Demodulator:
{
    MergeServer = "flarm-collector.opensky-network.org:20002";
};

Keep your other receiver settings and any existing Demodulator options. Leave your OGN APRS settings in place to continue feeding OGN. The OpenSky feed requires outbound UDP traffic to flarm-collector.opensky-network.org on port 20002.

Some images, installers and containers generate the receiver configuration automatically. In that case, follow your installation's documentation to update its persistent settings or configuration template, so the MergeServer setting survives a restart. Check the generated receiver configuration to confirm the setting above is present.

Save the file and restart your receiver service to apply the changes. On installations with separate ogn-rf and ogn-decode services, restart ogn-decode after this change. Make sure the collector hostname resolves before the decoder starts; if its log reports a name-resolution failure, restore DNS and restart the decoder.

Step 2: Verify Data Sharing

Check that both ogn-rf and ogn-decode are running, and check the decoder's logs or local status page for errors. While aircraft are being received, you can check outbound traffic on the receiver with:

sudo tcpdump -ni any 'udp dst port 20002'

Packets sent to the collector confirm that your receiver is transmitting the feed. A quiet receiver may send no packets until it receives aircraft messages. Aircraft appearing on a live map alone does not confirm that your station is feeding OpenSky.

Currently, OpenSky does not provide detailed statistics about individual FLARM sensors or feeds. However, if you have any questions or run into issues, feel free to reach out to the OpenSky team for assistance.