Getting Started

Getting Started

Requirements

Component	Minimum	Recommended
Board	Raspberry Pi 5 (4GB)	Raspberry Pi 5 (8GB)
OS	Raspberry Pi OS Bookworm arm64	Latest Bookworm image
NPU	None (CPU fallback)	Hailo-8 or Hailo-10H M.2 module
I/O	1x Sequent MegaBAS	2+ boards stacked (8 board types supported)
Network	Ethernet or WiFi	Ethernet + Tailscale
Storage	16GB SD	32GB+ SD

Quick Install (Headless)

curl -fsSL https://nexusedgehailo.automatanexus.com/install.sh \
  | sudo bash -s -- \
    --email you@example.com \
    --password yourpassword \
    --accept-eula \
    --config /path/to/site.toml

Headless Installer Flags

Flag	Required	Description
--email	Yes	Account email for AN Console registration
--password	Yes	Account password
--accept-eula	Yes	Accept the End User License Agreement
--config	No	Path to a pre-built site.toml (skips wizard)
-h8	No	Force Hailo-8 mode (skip auto-detect)
-h10	No	Force Hailo-10H mode (skip auto-detect)

If --config is omitted, the installer runs the 8-step Setup Wizard interactively.

Quick Install (GUI)

If you prefer a graphical installer, open a browser on the Pi and navigate to:

http://localhost:8080

The GUI installer walks through the same 8 steps visually: Site, Boards, Equipment, I/O Mapping, Algorithms, Notifications, Alarms, Review.

What the Installer Does

1. Detects I2C boards (8 board types) and Hailo NPU (H8 or H10H auto-detect)
2. Installs runtime dependencies (hailort, i2c-tools, cloudflared, tailscale)
3. Generates hardware-daemon.toml from detected boards
4. Registers the controller with the AN Console (Firebase + AegisDB write-through sync)
5. Provisions a Cloudflare tunnel for remote HTTPS access
6. Creates systemd service and starts NexusEdge on port 8000
7. Reboots automatically if kernel modules were installed (2-phase auto-reboot)

First Login

1. Open http://<pi-ip>:8000 in a browser (or use the Cloudflare tunnel URL)
2. Create an account or log in with Google
3. Run the Setup Wizard if you did not pass --config during install (8 steps: Site, Boards, Equipment, I/O Mapping, Algorithms, Notifications, Alarms, Review)

Console Access

After installation, the controller syncs to the AN Console:

• Console URL: https://nexusedgehailo.automatanexus.com/portal.html
• Features: 13 pages, multi-tenant fleet management, 3-level RBAC, OTA deploy, audit trail
• See Console for full details.

Cloudflare Tunnel (Remote Access)

The installer provisions a Cloudflare tunnel for HTTPS access from anywhere:

https://nexuscontroller-<serial>.automatacontrols.com

Next Steps

• Installation -- detailed manual installation steps
• Console -- 13-page console overview
• Equipment Types -- supported HVAC equipment
• Control Algorithms -- algorithm selection guide
• Pricing -- tier comparison and controller limits