Installation

Installation

Automated Installer

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

Manual Installation

1. Flash Raspberry Pi OS

# Use Raspberry Pi Imager with:
# 2025-10-01-raspios-bookworm-arm64.img.xz

2. Enable I2C

sudo raspi-config  # Interface Options → I2C → Enable
# Or manually:
echo "dtparam=i2c_arm=on" | sudo tee -a /boot/firmware/config.txt
sudo reboot

3. Install Dependencies

sudo apt-get update
sudo apt-get install -y i2c-tools hailort

# Tailscale (remote access)
curl -fsSL https://tailscale.com/install.sh | sudo sh
sudo tailscale up --hostname=<controller-name>

# Cloudflared (HTTPS tunnel)
sudo apt-get install -y cloudflared

4. Install MegaBAS CLI

cd /tmp && git clone https://github.com/SequentMicrosystems/megabas-rpi.git
cd megabas-rpi && sudo make install

5. Download Binary

Download the latest release from the Releases page:

wget https://github.com/AutomataNexus/NexusEdgeHailoEdition/releases/latest/download/nexusedge-community-pi5-bookworm-aarch64.tar.gz
tar xzf nexusedge-community-pi5-bookworm-aarch64.tar.gz
sudo install -m 755 nexusedge-community /usr/local/bin/nexusedge

6. Create Config

sudo mkdir -p /etc/nexusedge/config /var/lib/nexusedge/vault /var/lib/nexusedge/aegisdb /var/log/nexusedge
# Copy and edit site.toml from the example:
sudo cp config/site.toml.example /etc/nexusedge/config/site.toml

7. Create Systemd Service

# /etc/systemd/system/nexusedge.service
[Unit]
Description=NexusEdge Hailo Edition
After=network.target hailort.service

[Service]
Type=simple
User=root
WorkingDirectory=/etc/nexusedge
Environment=NEXUSEDGE_HEADLESS=1
ExecStart=/usr/local/bin/nexusedge
Restart=always
RestartSec=10
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now nexusedge

8. Verify

curl http://localhost:8000/  # Should return HTML
curl http://localhost:6100/health  # Talos daemon health

MegaBAS Firmware Update

Boards should run firmware v4.0+:

cd /tmp/megabas-rpi/update
echo "yes" | sudo ./update64 <stack>  # One board at a time, service stopped

Docker Installation

docker pull ghcr.io/automatanexus/nexusedge-hailoedition:latest
docker-compose up -d

Kubernetes / Helm

helm install nexusedge oci://ghcr.io/automatanexus/charts/nexusedge-community