aeromux/aeromux.example-single.yaml at main · aeromux/aeromux · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
# Aeromux Configuration — Single SDR Example
# Example configuration for deployments with a single RTL-SDR device.
# Copy to aeromux.yaml and customize for your setup.

# Logging configuration
logging:                                  # Structured logging configuration
  level: debug                            # Minimum log level: verbose | debug | information | warning | error | fatal
  console:                                # Console output configuration
    enabled: false                        # Enable for: development, Docker containers, or systemd services
    colored: true                         # Use ANSI color codes (disable if piping to log aggregators)
  file:                                   # File output configuration
    enabled: true                         # Enable/disable file logging
    path: "logs/aeromux-.log"             # Log file path with date placeholder
    rollingInterval: day                  # File rotation interval: day | hour | month
    retainedFileCount: 7                  # Number of old log files to keep
    fileSizeLimitMb: 100                  # Maximum size per log file in megabytes

# SDR device configuration
sdrSources:                               # List of SDR devices to use (multiple devices supported)
  - name: primary                         # Friendly name for this device
    deviceIndex: 0                        # RTL-SDR device index (0 for first device)
    gainMode: manual                      # Gain mode: manual (use tunerGain) | agc (automatic gain control)
    tunerGain: 49.6                       # Tuner gain in dB (default: 49.6 dB max sensitivity, reduce if near airport)
    ppmCorrection: 0                      # Frequency correction in parts per million
    # preambleThreshold: 1.8125           # Preamble detection sensitivity (default: 1.8125, range: 1.5-10.0)
    enabled: true                         # Enable/disable this device
    # deduplicationWindow: 50             # Deduplication time window in milliseconds (default: 50ms)
    # maxTrackedFrames: 1000              # Maximum frames to track for deduplication (default: 1000)

# Network ports and binding
network:                                  # Network server configuration
  beastOutputPort: 30005                  # Beast binary protocol output port (default: 30005, dump1090-compatible)
  beastOutputEnabled: true                # Enable Beast output (default: true)
  jsonOutputPort: 30006                   # JSON streaming output port (default: 30006, web-friendly)
  jsonOutputEnabled: false                # Enable JSON output (default: false)
  sbsOutputPort: 30003                    # SBS BaseStation text protocol output port (default: 30003, VRS-compatible)
  sbsOutputEnabled: false                 # Enable SBS output (default: false)
  apiPort: 8080                           # REST API port (default: 8080)
  apiEnabled: true                        # Enable REST API (default: true)
  bindAddress: "0.0.0.0"                  # Network interface to bind (0.0.0.0 = all interfaces, 127.0.0.1 = localhost only)

# Aircraft tracking settings
tracking:                                 # Aircraft state tracking configuration
  confidenceLevel: medium                 # ICAO confidence filter: low (5), medium (10), high (15) detections required
  icaoTimeoutSeconds: 30                  # Remove ICAOs not seen within this many seconds (prevents memory growth)
  # aircraftTimeoutSeconds: 60            # Remove aircraft after this many seconds of no messages
  # maxHistorySize: 1000                  # History buffer size for all tracking histories (position/altitude/velocity)
  # enablePositionHistory: true           # Enable position history tracking (circular buffer)
  # enableAltitudeHistory: true           # Enable altitude history tracking (circular buffer)
  # enableVelocityHistory: true           # Enable velocity history tracking (circular buffer)
  # enableStateHistory: true              # Enable combined state history (position + altitude + velocity)

# Receiver station location (optional)
receiver:
  latitude: 46.907982                     # Receiver latitude in decimal degrees (-90 to +90)
  longitude: 19.693172                    # Receiver longitude in decimal degrees (-180 to +180)
  altitude: 120                           # Receiver altitude in meters above sea level (optional)
  name: "Kecskemét"                       # Friendly name for this receiver station (optional)
  # Optional: UUID for MLAT triangulation and receiver identification
  # IMPORTANT: Each receiver MUST have a unique UUID. Do NOT reuse UUIDs across multiple receivers.
  # Generate a new UUID with: uuidgen (macOS/Linux), [guid]::NewGuid() (PowerShell), or https://www.uuidgenerator.net/
  # receiverUuid: "00000000-0000-0000-0000-000000000000"  # Replace with YOUR unique UUID

# Aircraft metadata database
database:
  enabled: false                          # Enable database enrichment at runtime (default: false)
  path: "artifacts/db/"                   # Directory for database storage (relative or absolute path)

# MLAT (Multilateration) input configuration
mlat:
  enabled: true                           # Enable MLAT input from mlat-client (default: true, daemon mode only)
  inputPort: 30104                        # TCP port to receive MLAT positions from mlat-client (default: 30104)