Skip to content

Quick Start

Jump to bottom
Kris Armstrong edited this page May 19, 2026 · 1 revision

Quick Start

Install

macOS (Apple Silicon or Intel)

# Download the latest .pkg from Releases:
gh release download --repo krisarmstrong/seed --pattern '*-darwin-arm64.tar.gz'
tar -xzf seed-*-darwin-arm64.tar.gz
sudo ./seed

The binary listens on https://localhost:8443 with a self-signed certificate. Your browser will warn — accept the exception once. (mkcert-style trusted local certs are tracked as a follow-up.)

Linux

Pick the package matching your distro:

# Ubuntu / Debian
gh release download --repo krisarmstrong/seed --pattern '*_amd64.deb'
sudo dpkg -i seed_*_amd64.deb

# Fedora / RHEL
gh release download --repo krisarmstrong/seed --pattern '*.x86_64.rpm'
sudo rpm -ivh seed-*.x86_64.rpm

Both packages install a systemd unit; the service starts automatically. Visit https://<host>:8443.

Windows

gh release download --repo krisarmstrong/seed --pattern "*-windows-amd64.zip"
Expand-Archive .\seed-*-windows-amd64.zip
.\seed.exe

First run

  1. Navigate to https://localhost:8443/ (or wherever you installed it).
  2. The setup wizard appears. The backend pre-generates a strong password — accept it or set your own. The wizard also displays the admin username (default: admin).
  3. Save. You're logged in.

What you'll see

The Roots dashboard is the default landing. From there:

  • Roots — path / hop analysis from this host outward
  • Canopy — Wi-Fi planning + scan
  • Shell — security posture (open ports, missing patches, weak ciphers)
  • Sap — live telemetry stream
  • Harvest — saved snapshots / reports

Pre-flight checks

  • Raw socket privileges: ICMP traceroute + ARP discovery need CAP_NET_RAW. The .deb/.rpm install handles this via systemd AmbientCapabilities. For the dev binary, see Contributing — make dev-run sets the cap for you.
  • Network access: plug into the network you want to diagnose. Seed auto-selects the most "interesting" interface but you can change it in Settings.

Verify the install

curl -sk https://<host>:8443/__version | jq

Expected response:

{
  "version": "vX.Y.Z",
  "commit": "abcd1234",
  "buildTime": "2026-05-18T22:42:09Z",
  "uiBuildHash": "f51f1faf43d456d984f528c66a89f3d0"
}

uiBuildHash non-empty confirms the React frontend was embedded (i.e., a real make build, not a backend-only make quick).

Clone this wiki locally