Installation

brew tap zeroedin/alloy-ssg
brew install alloy-ssg

This installs a prebuilt binary for macOS (Apple Silicon and Intel) or Linux (amd64 and arm64). Verify the installation:

alloy version

To upgrade, run brew update first to refresh tap metadata, then upgrade:

brew update && brew upgrade alloy-ssg

Homebrew caches tap formula definitions locally. Third-party taps like zeroedin/alloy-ssg can go stale if you haven’t run brew update recently — brew upgrade alloy-ssg may report “already installed” even when a new version is available. Running brew update first forces a fresh pull of the formula.

Windows

On Windows, use WSL and install via Homebrew inside your Linux environment. Alternatively, download a prebuilt binary from the GitHub releases page:

  1. Download alloy-windows-amd64.zip (or alloy-windows-arm64.zip for ARM)
  2. Extract the zip
  3. Move alloy.exe to a directory on your PATH

Go install

If you already have a Go toolchain, you can install from source:

go install github.com/zeroedin/alloy@latest

This compiles and installs the alloy binary to your $GOPATH/bin directory. Requires Go 1.25 or later.

Build from source

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/

Prerequisites

  • Node.js (optional). Only required if your project uses Tier 3 plugins (Node subprocess plugins). The core binary has zero runtime dependencies.

Verify your installation

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

alloy init scaffolds a complete starter project – config file, directories, a default layout, an index page, and a stylesheet. alloy build runs the pipeline and writes output to _site/.

What’s next