Installation

Get Tarn up and running on your system.

Distribution Roadmap

The current release is v0.2.8-beta.

Prebuilt Docker images, a Homebrew tap, and a one-line installer script are planned for future releases. For now, the primary install paths are release binaries or building Tarn from source.

See the project roadmap for the broader direction.

From Releases

Download the pre-built binary for your platform:

curl -L https://github.com/aircwo-systems/tarn/releases/download/v0.2.8-beta/tarn-darwin-arm64.tar.gz \
  | tar xz

From Source

Build Tarn from the latest development version:

git clone https://github.com/aircwo-systems/tarn.git
cd tarn
make build
./build/tarn start

Requirements

• Go 1.26+ (for building)
• Docker (required for Lambda execution)
• make and standard Unix tools

Using Docker

Build a local Tarn image from source and run it in Docker:

# Build image
make docker-build

# Run container
docker run -p 4566:4566 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  tarn:0.1.0-dev

The -v /var/run/docker.sock:/var/run/docker.sock mount allows Tarn to create Lambda containers.

With Dashboard

Include the built-in web dashboard:

# Build with UI
make docker-build-ui

# Run
docker run -p 4566:4566 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  tarn:0.1.0-dev-ui

# Open in browser
open http://127.0.0.1:4566

Verify Installation

Check that Tarn is working:

./tarn version

Release binary output: tarn <DocsVersionCode />

Source builds may report the repository development version instead.

Optional: Install awslocal

If you prefer AWS CLI-compatible commands without repeating --endpoint-url, install awslocal:

pipx

pipx install awscli-local

pip

pip install awscli-local

Then point it at Tarn:

export AWS_ACCESS_KEY_ID=test
export AWS_SECRET_ACCESS_KEY=test
export AWS_DEFAULT_REGION=us-east-1
export AWS_ENDPOINT_URL=http://127.0.0.1:4566

awslocal lambda list-functions

Next Steps

• Quick Start
• Configuration
• Services Overview