Self-hosting
Guide Documentation category

Self-hosting

Configure, deploy, migrate, monitor, upgrade, and troubleshoot an Agent Barn environment.

For
Platform engineers and self-hosted operators

Available documentation

Concept

Runtime Assembly and Deployment

Trace Agent startup, runtime builders, Kubernetes resources, environment isolation, deployments, and monitoring.

Guide

Local Development, Operations, and Releases

Install dependencies, run services, migrate data, deploy safely, operate staging, send email, and monitor the stack.

Reference

Configure a self-hosted platform

Configure Agent Barn’s identity, databases, model proxy, Agent runtimes, networking, storage, email, integrations, background workers, and monitoring.

Guide

Deploy Agent Barn to Kubernetes

Deploy Agent Barn, its supporting services, agent runtimes, and monitoring stack to a Kubernetes cluster using Helmfile.

Reference

Configure a production deployment

Harden an Agent Barn Kubernetes deployment for production with isolated environments, stable-secret custody, least-privilege access, durable storage, backups, monitoring, staged releases, and recovery preparation.

How-to

Manage database migrations

Create, review, test, apply, verify, and recover Agent Barn database migrations using Alembic in local, staging, and production environments.

How-to

Monitor the platform

Deploy, verify, and operate Agent Barn’s namespace-scoped Prometheus, Grafana, Alertmanager, Agent health, API, database, Tool Call, LiteLLM, and OpenRouter monitoring.

How-to

Upgrade Agent Barn

Prepare, stage, deploy, verify, and recover Agent Barn upgrades across the API, UI, database, Agent runtimes, supporting services, and monitoring stack.

Guide

Troubleshoot self-hosting

Diagnose Agent Barn local and Kubernetes failures across startup, deployments, hooks, databases, storage, ingress, authentication, workers, Agents, telemetry, providers, and monitoring.

Documentation