deploy: host config from /etc/vanlink.conf (hosts/<hostname>.conf)

deploy.conf is replaced by one versioned file per host plus an example. deploy.sh validates the config, renders every template with a generic token loop, refuses to install output with leftover @TOKENs and gains --check/--templates. LAN_USB_IFACE is renamed LAN_IFACE. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-23 14:28:11 -04:00
parent 442010c4b8
commit 0cbbeb7aba
10 changed files with 235 additions and 75 deletions
@@ -0,0 +1,41 @@
+# 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            # Wi-Fi uplink (NetworkManager WAN)
+ONBOARD_LAN_IFACE=              # optional: extra onboard LAN port bridged into br0 (e.g. eth0); empty = none
+
+# --- 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)