# hosts/vanlink.conf.example — reference for /etc/vanlink.conf.
#
# Each host has hosts/<hostname>.conf (hostname -s) in this repo, and
# /etc/vanlink.conf is a symlink to it:
#   sudo ln -sfn "$PWD/hosts/$(hostname -s).conf" /etc/vanlink.conf
# Plain KEY=value (it is sourced by bash). NO SECRETS — this file is in git.
# Validate without root:  ./deploy.sh --check hosts/<hostname>.conf
# Find interface names with `ip -br link` (wired) / `iw dev` (wifi); USB IDs with lsusb.

# --- Interfaces -------------------------------------------------------------
WIFI_5G_IFACE=wlp1s0            # 5GHz AP radio (hostapd)
WIFI_2G_IFACE=wlx000000000000   # 2.4GHz AP radio (hostapd-2g)
LAN_IFACE=enp1s0                # wired LAN port, bridged into br0
STARLINK_IFACE=enp2s0           # Starlink uplink (NetworkManager WAN)
WIFI_WAN_IFACE=wlan0            # optional: Wi-Fi uplink (NetworkManager WAN); empty = none
ONBOARD_LAN_IFACE=              # optional: extra onboard LAN port bridged into br0 (e.g. eth0); empty = none

# --- Access point -------------------------------------------------------------
AP_SSID_5G=VanLink              # SSID of the 5GHz AP (hostapd.conf)
AP_SSID_2G=VanLink              # SSID of the 2.4GHz AP (hostapd-2g.conf)
# Radio-specific lines for the 5GHz AP: hostapd lines separated by the two characters \n
# (the GNU sed used by `render` expands them to newlines). Keep it in single quotes, e.g.
#   AP_5G_RADIO='ht_capab=[HT40+][SHORT-GI-20]\nvht_capab=[RXLDPC][SHORT-GI-80]'
AP_5G_RADIO='ht_capab=[HT20][SHORT-GI-20]'

# --- Addressing ---------------------------------------------------------------
GATEWAY_IP="10.42.9.1"
GATEWAY_PREFIX="24"
GATEWAY_NETWORK="10.42.9.0/24"
DHCP_RANGE_START="10.42.9.10"
DHCP_RANGE_END="10.42.9.254"
DNS_RESOLVERS="1.1.1.1 8.8.8.8"

# --- Hardware -----------------------------------------------------------------
MODEM_USB_VENDOR=2c7c           # cellular modem USB vendor id
NVME_DEVICE=                    # only when ENABLE_NVME_WATCH=1, e.g. nvme0
NVME_FS_DEVICE=                 # only when ENABLE_NVME_WATCH=1, e.g. /dev/nvme0n1p2

# --- Backup (read by failover/sync-*-backup.sh; leave empty if unused) ----------
USB_BACKUP_ROOT_PART=           # sync-usb-backup.sh: partition to mount, e.g. /dev/sda2
USB_BACKUP_MOUNT=               # sync-usb-backup.sh: local mount point, or host:/path for NFS
SD_BACKUP_UUID=                 # sync-sd-backup.sh: filesystem UUID of the backup SD card

# --- Feature flags (0 or 1) ---------------------------------------------------
ENABLE_COCKPIT=0                # Cockpit "Van Router" plugin
ENABLE_LI3=0                    # Li3 house-battery BLE -> MQTT service
ENABLE_NVME_WATCH=0             # NVMe timeout watchdog (needs an NVMe drive)
ENABLE_HA=0                     # Home Assistant + ESPHome (podman quadlets)
ENABLE_FRIGATE=0                # Frigate NVR (podman quadlet)
ENABLE_NM_WAN=1                 # NetworkManager owns the WANs (netplan, cellular profile) via --apply-network
ENABLE_LEDS=0                   # van-leds: drive the NanoPi R5C's power/LAN/WAN/WiFi LEDs (needs the nanopi-r5c-leds overlay)

# --- LEDs (used with ENABLE_LEDS=1; sysfs names under /sys/class/leds, empty = leave that LED alone)
LED_POWER=                      # e.g. red:power   (trigger default-on)
LED_LAN=                        # e.g. green:lan   (activity on LAN_IFACE)
LED_WAN=                        # e.g. green:wan   (active uplink from van-failover; heartbeat = link but no healthy internet)
LED_WLAN=                       # e.g. green:wlan  (activity on WIFI_5G_IFACE, the 5GHz AP radio)

CELLULAR_CONN_NAME=Koodo        # NM name of the cellular connection (also used by van-failover); needed with ENABLE_NM_WAN=1 when a cellular WAN is wanted
CELLULAR_APN=sp.koodo.com       # cellular APN; needed with ENABLE_NM_WAN=1 when a cellular WAN is wanted (no APN = no cellular profile)