Web Portal
Open from any device on your LAN:
http://<hostname>.local (default port 80; change with WEB_PORT in /etc/flightscnr.env)
Portal preferences are stored on the Pi in /var/lib/flightscnr/ and apply without wiping on update. Settings sections start collapsed; expand a card to edit.
| Section | Purpose |
|---|---|
| Radar | Center (lat/lon), range, distance/speed units, altitude floor/ceiling, custom accent color, runway centerline color, map style (Carto / OSM / Stadia / Flat / Toner / VFR / Esri / Voyager / satellite) with VFR opacity, compass, range rings, color by altitude, tag leaders, facing direction, sweep, precipitation, wildfires, earthquakes, airport overlays, ground vehicles, traffic mode (aircraft / marine / both), traffic labels (aircraft / marine / both / off), min speeds |
| Favorite Locations | Save up to 10 radar centers; search by ICAO; select / update / delete. Swipe left on the radar to cycle Home and saved favorites, or pick one under Settings → Options → Favorite Locations |
| Local ADS-B | dump1090 / readsb / tar1090 URL and enable (off by default on fresh installs) |
| Route Sources | Edit / save ROUTE_SOURCE_ORDER (airlabs, flightaware, opensky); omit a source to disable it; leave blank for default |
| Position Sources | Drag-reorder fallbacks for the Follow / Live map; optional rotate-map-to-heading; reset to default order |
| Alerts | Military, emergency squawk, flight-number / registration / aircraft-type watch lists, hide non-alerted aircraft |
| Tracking | Follow one flight number or registration worldwide; route search (origin + destination) for live flights |
| Display & screens | Brightness, rotation, flight-detail and clock timeouts, auto-return to clock, 12-hour clock, radar clock HUD (on/off, position, opacity, dark mode), hourly chime, tracked enter-range and military sounds, earthquake voice with enable, volume, and preview |
| Off-Hours | Night schedule - dim (slider) or turn off display; optional Show clock during off-hours (can combine with dim/off). Also used as the night window for [[Updates |
| Weather | °C / °F; manual current-weather fetch that bypasses the local cache while retaining the last good reading if the provider rate-limits |
| ATC Audio | Enable LiveATC, airport/channel, volume, quiet hours |
| Bluetooth Speaker | Scan, pair, select, and Forget a speaker for ATC and chime; switch USB vs Bluetooth output |
| API keys | FR24, Tomorrow.io, AirLabs, FlightAware / OpenSky (route fallback), ADS-B Exchange (optional position fallback), aisstream.io, NASA FIRMS, Stadia Maps - save or save & restart. Per-source enable toggles turn a source off without deleting its key |
| Updates | Check GitHub; Update Now; Later tonight; Auto-install during off-hours; Finish install; Repair & Update when needed |
| System | Download settings / Upload & apply backup; view and clear saved disclaimer acceptance; Relaunch app, Reboot, or Shutdown |
| Master Caution | Wipe & reinstall (two confirms) - deletes checkout, settings, keys, watch lists, and maps, then reinstalls from GitHub and reboots. Does not touch Wi‑Fi or dump1090. Download settings first if you want a backup. If the button fails with a sudo error, run Update Now or Finish install once so sudoers is updated |
·
·
| URL | Purpose |
|---|---|
/stats |
Overhead statistics: daily counts, daily average, busiest day, peak hour / day-of-week, and hour / day / airline / local-vs-flyover charts, plus a clickable daily log |
/stats/<date> |
Per-day drill-down for a single date (from the /stats daily log) |
/closest, /farthest
|
Maps and logs for the closest / farthest aircraft seen |
/counter |
Raw flight counter JSON |
/wifi |
Captive Wi‑Fi setup page (scan, connect, try saved) shown on the setup hotspot |
System → Download settings exports portal preferences (radar, display, alerts, weather, off-hours, favourites, location, ATC, and API keys) as a .config file. The file includes secrets - keep it private. It does not include map caches, photos, or /etc/flightscnr.env.
Upload & apply restores a previous export and relaunches the app. Remembered safety-disclaimer acceptance is intentionally not restored from backups.
The System card reports whether the current disclaimer version is remembered. Clear saved disclaimer acceptance makes the next boot wait for a physical touchscreen Accept.
For safety, the portal cannot enable or restore Don't show again. That choice can only be made on the device.
- Features - on-device screens and gestures
- Data Sources - which keys power which features
- Updates - updating from the portal
- Troubleshooting - stuck updates and touch issues
