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.
| 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.