Skip to main content

04. Server Settings

Server Settings

Treat Server Settings as infrastructure and maintenance.

1. Web Server Port and Admin Port

Web Server Port

  • Port used by the public radar (/AircraftList.json, map frontend).

Admin Port

  • Port used by the admin panel (/admin).
  • Recommended: use a dedicated admin port, separate from radar.

If AdminPort = 0 or equals WebServerPort, admin endpoints share the same port as public radar, which increases exposure.

2. Network Binding

This setting controls whether the server listens on:

  1. localhost only,
  2. all interfaces (0.0.0.0) for LAN/VPN/public routing.

A restart is required after changing binding behavior.

3. Radar Visibility

This setting controls radar authentication:

  1. Public - radar is accessible without login.
  2. Private - radar requires authentication.

This is independent from Network Binding.

4. Database and Imports

Database File Name

  • SQLite database file path/name.
  • Changing it may require restart.

Data import options

  • OpenSky CSV
  • ADS-B Exchange JSON/NDJSON
  • Airport CSV (OurAirports-compatible)
  • BaseStation SQLite upload (BaseStation.sqb, .sqlite, .db, .sqlite3)

BaseStation file import note:

  1. Use the file selector in Server Settings (no manual path typing required).
  2. Replace - swaps the whole DB file and creates a .bak backup.
  3. Merge - keeps current DB file and upserts aircraft records by ModeS.

ADSBX note:

  1. basic-ac-db.json.gz includes native mil flag support (military classification).
  2. There is no dedicated government field in this dataset.
  1. Confirm source URL is valid and in expected format.
  2. Run import.
  3. Check server logs.
  4. Verify results on map/list.

AircraftDB Editor and custom photos

Dedicated guide:

  1. 15. Aircraft DB Editor & Custom Photos

Quick summary:

  1. ModeS must stay unique (duplicate create/update is blocked),
  2. editor provides Load existing aircraft path for duplicate ICAO conflicts,
  3. custom aircraft photo can be uploaded per ICAO and has priority over PlaneSpotters.

5. Configuration Backup

This section provides:

  1. settings export,
  2. settings import.

After importing configuration:

  1. verify ports,
  2. verify binding,
  3. restart service if required.

6. Danger Zone

Clear Application Data removes critical data (configuration, users, mappings, database).

Use only when:

  1. performing full instance reset,
  2. current backups exist,
  3. irreversible data loss is accepted.
Back to top