Overview
Run the open-source AgentConnect stack on your own infrastructure with Docker Compose or the official Helm chart.
AgentConnect OSS is the open-source, self-hosted AgentConnect stack. Choose Docker Compose for a local evaluation with daemons on your own machines, or the official Helm chart for a production-shaped deployment with agents running in isolated Kubernetes sandboxes.
The source is available in the AgentConnect repository.
Docker Compose
Start the stack on one machine and connect a daemon on the host
Kubernetes
Install the Helm chart and let the cluster own agent execution and workspaces
What is configured where
| Surface | Owns |
|---|---|
compose.env or Helm values | Images, ports, public URLs, database secrets, Vault, connectors, and Logto endpoints |
| Setup Server | Logto browser auth, GitHub, GitLab, Gitea, Linear, Slack, Google, Google Chat, Lark / Feishu tenant apps, and deployment options |
| AgentConnect console | Organizations, agents, integrations, environments, tools, and skills |
Setup Server is the supported configuration surface for browser authentication, provider apps, displayed sign-in methods, and preset-agent behavior. It saves deployment settings and write-only provider secrets in PostgreSQL. It ships with both topologies and never gets a public route: Compose binds it to loopback, and the chart gives it no Service, so you reach it from your workstation. Sign-in and Provider apps cover what it configures.
Agent execution remains daemon-local. The Control Plane stores coordination data rather than message bodies, attachment bytes, workspaces, or live agent-session streams. See How it works.
How is this guide?