Configuration File Options
The fully pre-configured FlightAware PiAware 3 SD card includes a default configuration that can be edited or overriden by the user.
The configuration file allows the user to configure and set the following:
Configuration File Format
- Wired network
- Wireless (WiFi) network
- Automatic or manual updates
- Multilateration (MLAT) output
- Receiver type (RTL-SDR, Beast, Radarcape or other Mode S/ADS-B source)
- RTL-SDR gain, PPM and device index
The configuration file is a simple plain text format file. You may find it helpful to view the sample piaware-config.txt.
Lines beginning with a "#" are comment lines and are ignored. Blank lines are also ignored. All other lines specify configuration settings.
If no other configuration method (above) is used, then the configuration file location is /etc/piaware.conf. This file is intended for package-based installs that do not want to use /boot.
For most users: After writing the PiAware image to a SD card, place the SD card in your computer and edit the "piaware-config.txt" file using a text editor (such as Notepad on Windows). Save your changes and eject the SD Card before physically removing it. Place the SD card in your Pi and it will use the new configuration when powered on.
Editing the configuration from the command line
For advanced users: Log in to your Pi by attaching keyboard and screen or by using ssh, then either:
Use the "piaware-config" utility to view and change settings. Run "piaware-config <setting> <value>" to make changes. Run "piaware-config" to show the current configuration settings.
Edit /boot/piaware-config.txt to make configuration changes, using an editor of your choice (e.g. "sudo nano /boot/piaware-config.txt").
For package-based installs, use piaware-config or edit /etc/piaware.conf.
If it is not convenient to remove the SD card and command line access is not possible. an external USB flash drive containing a piaware-config.txt file can be attached to the Pi. Settings in that file override any settings on the SD card. The flash drive should be attached before powering on the Pi and should remain connected while the Pi is running.
To ensure that all configuration changes take effect, please restart/reboot the Raspberry Pi after making changes.
For details on all available configuration options, please see our Advanced Configuration documentation.