Getting Started

Getting Started

Requirements

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

Quick Install

curl -fsSL https://nexusedgehailo.automatanexus.com/install.sh | sudo bash

The installer will:

1. Detect I2C boards and Hailo NPU
2. Install runtime dependencies (hailort, i2c-tools, cloudflared, tailscale)
3. Generate hardware-daemon.toml from detected boards
4. Prompt for ZIP code (weather) and site name
5. Create systemd service
6. Start NexusEdge on port 8000

First Login

1. Open http://<pi-ip>:8000 in a browser
2. Create an account or log in with Google
3. Run the Setup Wizard (8 steps: Site, Boards, Equipment, I/O Mapping, Algorithms, Notifications, Alarms, Review)

Cloudflare Tunnel (Remote Access)

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

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

Next Steps

• Configuration — site.toml and hardware-daemon.toml reference
• Equipment Types — supported HVAC equipment
• Control Algorithms — algorithm selection guide