Skip to content

Home Node Configuration

Example configuration for a fixed relay node at home with stable power and good antenna placement.

owner:
  long_name: "JTXMesh Home Node"
  short_name: "JTXH"

device:
  # Set a stable/unique node name (avoid personal info)
  node_name: "JTX-RELAY-<AREA>-01"

radio:
  # Conservative power for fixed nodes; adjust based on antenna gain and coverage needs
  tx_power_dbm: 17
  # region must match your actual hardware/firmware region settings
  region: "US"

position:
  # Fixed nodes should share position if it's acceptable.
  # If privacy is a concern, set to false or set a coarse/approx position.
  gps_enabled: false
  fixed_position: true
  # Optional: manually set a fixed position if supported by your tooling.
  # latitude: 33.xxxxxx
  # longitude: -97.xxxxxx
  # altitude: 0

telemetry:
  # Keep telemetry conservative for airtime health.
  enabled: true
  interval_secs: 900

channels:
  # Channel plan: 0 Primary, 1 Emergency, 2 CERT, 3 Ops, 4 Test
  - index: 0
    name: "Primary"
    role: "PRIMARY"
    encrypted: false
    psk_base64: "PRIMARY_PSK_BASE64"

  - index: 1
    name: "Emergency"
    role: "SECONDARY"
    encrypted: true
    psk_base64: "EMERGENCY_PSK_BASE64"

  - index: 2
    name: "CERT"
    role: "DISABLED"   # Enable only for CERT members / trained volunteers
    encrypted: true
    psk_base64: "CERT_PSK_BASE64"

  - index: 3
    name: "Ops"
    role: "SECONDARY"  # Node ops coordination
    encrypted: true
    psk_base64: "OPS_PSK_BASE64"

  - index: 4
    name: "Test"
    role: "DISABLED"   # Leave disabled unless actively testing
    encrypted: true
    psk_base64: "TEST_PSK_BASE64"

mqtt:
  # Home relays may optionally bridge via MQTT if you run a trusted gateway.
  enabled: false
  # If enabled, keep it locked down and documented.
  # address: "mqtts://<broker>:8883"
  # username: "<user>"
  # password: "<pass>"
  # root_topic: "msh/US/JTXMesh"
  # tls: true
  # uplink: true
  # downlink: true

power:
  # Fixed nodes: prefer stable power profiles
  is_router: true
  power_saving: false