agilerr.app

Docs

Developer-oriented setup notes for running Agilerr from a binary, Docker Compose, or a local development environment.

Run From A Binary

Download the archive for your platform, extract it, and run the Agilerr binary. This is the simplest way to evaluate or self-host the app on a single machine.

curl -L https://agilerr.app/downloads/agilerr-linux-amd64.tar.gz | tar xz
./agilerr

Run With Docker Compose

Use the published compose file when you want the service isolated inside a container with a mounted data volume and explicit environment variables.

curl -O https://agilerr.app/install/docker-compose.yml
docker compose up -d

Run In Dev Mode

For product development, run the Go backend and the Vite frontend separately. This keeps fast frontend iteration while the backend owns API and PocketBase startup.

cd backend && go run .
cd frontend && npm run dev

Enable AI Add

AI Add is optional. Set OpenAI environment variables before starting the backend if you want the planning assistant enabled.

export OPENAI_API_KEY="sk-..."
export OPENAI_BASE_URL="https://api.openai.com"
export OPENAI_MODEL="gpt-5-mini"

Downloads

Linux x64 Linux ARM64 macOS Apple Silicon macOS Intel Windows x64 Docker Compose file

Repo

The source code, issues, and release workflow live in the public GitHub repository.

github.com/rmalcomber/agilerr

Environment

ADMIN_EMAIL and ADMIN_PASSWORD seed the first admin.
PB_DATA_DIR controls where PocketBase stores data.
HTTP_ADDR controls the bind address and port.
AGILERR_API_KEY enables API key access for REST and MCP.
OPENAI_API_KEY enables AI Add.