> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ellomas.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install Replay via Go, binary download, or Docker.

# Installation

There are several ways to install Replay.

## Go Install

If you have Go 1.25+ installed:

```bash theme={null}
go install github.com/replay/replay@latest
```

This builds the binary and places it in `$GOPATH/bin`.

## Binary Download

Download a pre-built binary from the [GitHub Releases](https://github.com/tomiwa-a/replay/releases) page.

Available platforms:

| OS             | Architecture |
| -------------- | ------------ |
| Linux          | amd64, arm64 |
| macOS (Darwin) | amd64, arm64 |
| Windows        | amd64        |

```bash theme={null}
# Example: Linux amd64
curl -LO https://github.com/tomiwa-a/replay/releases/latest/download/replay_linux_amd64.tar.gz
tar -xzf replay_linux_amd64.tar.gz
sudo mv replay /usr/local/bin/
```

## Docker

Pull the official Docker image:

```bash theme={null}
docker pull ghcr.io/replay/replay:latest
```

Run a workflow from your current directory:

```bash theme={null}
docker run --rm -v $(pwd):/app ghcr.io/replay/replay:latest run /app/workflow.yaml
```

## Build from Source

```bash theme={null}
git clone https://github.com/tomiwa-a/replay.git
cd replay
make build
```

The binary is output to `./build/replay`.

## Verify

```bash theme={null}
replay version
```

Expected output:

```
replay dev (commit: none, built: unknown, darwin/arm64, go1.25.0)
```

## Shell Autocompletion

Replay uses Cobra, which supports shell completion:

```bash theme={null}
# Bash
source <(replay completion bash)

# Zsh
source <(replay completion zsh)

# Fish
replay completion fish | source
```

## What's Next?

* Follow the [Quickstart](/replay/quickstart) guide
* Learn about [writing workflows](/replay/guides/writing-workflows)