Quickstart

import { Steps, Callout } from ‘@astrojs/starlight/components’;

Get from a clean install to live results in minutes. You’ll download and run the server (with local auto-approval), enroll one probe node, and open the UI.

Pre-built binaries ship for **macOS** and **Linux** (amd64 + arm64). The installer detects your platform and verifies the SHA256 checksum automatically. Windows users can use `install.ps1`. See [Requirements](/requirements/) for runtime details.

1. Install the server binary

On the host that will run the central server (macOS or Linux):

curl -fsSL https://foureyes.space/install.sh \
  | sh -s -- --component server

This downloads the right binary for your OS/arch, verifies it against the published checksums, and installs foureyes to /usr/local/bin.

2. Generate local mTLS certificates

The server needs a CA and a server certificate on first run. Generate a local set:

foureyes --dev-certs   # writes a local CA + server/node certs under ./dev

3. Start the server

Start the server with local auto-approval enabled so nodes you enroll are approved instantly (dev convenience — leave it off in production):

FOUREYES_AUTO_APPROVE=true foureyes

The server listens for nodes on gRPC (:8443) and serves REST + the UI on :8444.

4. Enroll a probe node

Issue an enrollment token in the UI (Nodes → “issue token”), then on the node host install and start the node binary:

curl -fsSL https://foureyes.space/install.sh \
  | sh -s -- --component node --token=4E-... --server=server.host:8443

Replace 4E-... with your real token and server.host:8443 with your server’s address. On systemd hosts this also writes the node env file and installs + starts the foureyes-node service; elsewhere it prints the command to run manually.

5. Open the UI

https://localhost:8444

You should see your node connected and ready to take test assignments.

Next steps

Create a test (HTTP, DNS, path, BGP, browser, transaction, voice, …) from the UI.
Wire up alerting or a dashboard.
Manage everything as code with foureyesctl.