Argyll logo Argyll

Installation

Start a local cluster with Docker Compose or build a single engine node from source.

Docker Compose

The fastest way to get a 3-node cluster running:

git clone https://github.com/kode4food/argyll
cd argyll
docker compose up

This starts three engine nodes behind an HAProxy proxy on http://localhost:8080.

Building from Source

Prerequisites

  • Go 1.27+
  • Node.js 20+ (for the web UI)
  • Make

Build the Engine

git clone https://github.com/kode4food/argyll
cd argyll/engine
go build -o argyll ./cmd/argyll

Run a Single Node

RAFT_NODE_ID=argyll-1 \
RAFT_ADDRESS=127.0.0.1:9701 \
RAFT_DATA_DIR=/tmp/argyll-raft/argyll-1 \
RAFT_SERVERS=argyll-1=127.0.0.1:9701 \
WEBHOOK_BASE_URL=http://localhost:8080 \
./argyll

The engine listens on port 8080 by default.

See Configuration for environment variables, Raft cluster setup, retry defaults, and production routing.

Verify Installation

curl http://localhost:8080/engine

The response contains the registered Steps, Attribute graph, and current node health.

Continue with the Quick Start and Concepts.

Previous Quick Start