selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Warren logo

Self-host Warren

v0.19.3

Infrastructure for coding-agent workloads

BetaOpen SourceMIT
Updated5 days ago
LanguageTypescript
Setup difficultyAdvanced
Stars
509
Ports
8080 (HTTP API and UI), 8081 (Preview environments)
Docker
ghcr.io/jayminwest/warren
Install with Docker
Operations dashboard showing control-plane health, lifecycle snapshot, active workloads, and structured event logRuns list showing every workload with state, duration, cost, and Git deliveryRun detail page with lifecycle pipeline, live event stream, budget, and merged pull requestAgents page showing harness definitions available for dispatch

What is Warren?

Warren is a self-hosted control plane for running coding agents as managed workloads. It handles the complete run lifecycle: setting up a fresh workspace, executing the agent in a sandbox (local bwrap, Docker sibling containers, or Kubernetes pods), streaming live events, enforcing spend and concurrency limits, allowing steering and cancellation, recovering from failures, and delivering results via Git with optional pull requests. The project works with Pi and Claude Code agents. One deployment serves a single operator or trusted team, protected by a bearer token. Supported Git forges include GitHub (App or PAT), GitLab, and Azure DevOps Repos. Optional extensions add audit logging, run judging, campaign controllers, and issue tracker integrations. Licensed under MIT.

Should you self-host Warren?

Warren scores 52/100 on selfhost.directory (how scoring works) and ranks #86 of 209 in AI Agents. It has 509 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v0.19.3, came out on 7 October 2026. New versions land roughly every 3 days.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Orca (91/100, 108 446 stars). It scores higher overall, so compare the two before you pick. See Warren vs Orca side by side.

Features

  • Cost and token tracking
  • Extension SystemExtensions are optional and not part of base installation
  • Git delivery with pull requests
  • HTTP API and CLI
  • Isolated agent workloads
  • Live event streaming
  • Multiple Git forge support
  • Multiple runtime providers
  • Preview environments
  • Recovery and cleanup
  • Spend and concurrency limits
  • Steering and cancellation

Warren README

How to install Warren

Install Warren with Docker

Linux Docker host; Docker socket access; agent image built from deploy/docker/Dockerfile.agent
Environment variables
WARREN_RUNTIME=docker, WARREN_DATA_DIR, ANTHROPIC_API_KEY, GITHUB_TOKEN, WARREN_GIT_AUTHOR_NAME, WARREN_GIT_AUTHOR_EMAIL

docker build -f deploy/docker/Dockerfile.agent -t warren-agent:latest . export ANTHROPIC_API_KEY=sk-ant-... export GITHUB_TOKEN=ghp_... export WARREN_GIT_AUTHOR_NAME=your-bot-login export WARREN_GIT_AUTHOR_EMAIL=1234567+your-bot-login@users.noreply.github.com docker run -d --name warren --restart unless-stopped
-p 8080:8080
-v /var/run/docker.sock:/var/run/docker.sock
-v "$(command -v docker)":/usr/bin/docker:ro
-v /srv/warren:/srv/warren
-e WARREN_RUNTIME=docker
-e WARREN_DATA_DIR=/srv/warren
-e ANTHROPIC_API_KEY
-e GITHUB_TOKEN
-e WARREN_GIT_AUTHOR_NAME
-e WARREN_GIT_AUTHOR_EMAIL
ghcr.io/jayminwest/warren:v0.18.0

Requires Docker socket mount, Docker CLI in container, shared data directory path; no elevated security flags needed

Warren releases & version history

More in CI/CD

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…