Installation

Install Alloy with a single go install command:

go install github.com/zeroedin/alloy@latest

This downloads, compiles, and installs the alloy binary to your $GOPATH/bin directory. Verify the installation:

alloy version

Prerequisites

  • Go 1.21 or later. Alloy uses modern Go features and module dependencies that require 1.21+. Check your version with go version.
  • Node.js (optional). Only required if your project uses Tier 3 plugins (Node subprocess plugins). The core binary has zero runtime dependencies.

Build from source

Clone the repository and build directly:

git clone https://github.com/zeroedin/alloy.git
cd alloy
go build -o alloy .

Move the binary to a directory on your PATH:

mv alloy /usr/local/bin/

Or install it directly into your $GOPATH/bin:

go install .

Verify your installation

Create a minimal site and run a build:

mkdir my-site && cd my-site
alloy init
alloy build

alloy init creates a default alloy.config.yaml with a title and base URL. alloy build runs the pipeline and writes output to _site/. A project with no content produces a successful zero-page build.

What’s next