> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openhands.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Docker Compose

> Run OpenHands Enterprise with Docker Compose

The Docker Compose stack runs OpenHands Enterprise on a single machine. Use it to evaluate
OpenHands Enterprise with a small group of users. For production, we recommend
[Kubernetes](https://docs.openhands.dev/enterprise/k8s-install/index).

## Prerequisites

* Git
* Docker and Docker Compose
* An API key from your LLM provider

## Install

**1. Start the stack**

```bash theme={null}
git clone https://github.com/OpenHands/enterprise.git
cd enterprise
./scripts/setup.sh
```

The script returns when every service is healthy, then prints the URL to open. On the first
start, the application pulls images, which can take several minutes.

**2. Complete onboarding**

Open the URL the script printed and follow the onboarding flow to create your first user and
configure your LLM provider.

On a fresh stack, follow the first Super Admin's
[setup guide](https://docs.openhands.dev/enterprise/super-admin.md#setup-guide) to add an LLM, connect Git, and invite users.
This Enterprise guide is separate from the
[local Agent Canvas first-time wizard](https://docs.openhands.dev/openhands/usage/agent-canvas/first-time-setup.md).

## Share with your team

By default, the stack is only reachable from the machine it runs on. To share it with others,
serve it over HTTPS with [ngrok](https://docs.openhands.dev/enterprise/docker-compose/ngrok.md) or run it on a
[VM with your own domain](https://docs.openhands.dev/enterprise/docker-compose/https.md).

## Upgrade

Pull the latest changes, then restart the stack:

```bash theme={null}
git pull
docker compose down
./scripts/setup.sh
```

The application migrates its database on startup.

## Stop and reset

Stop the stack with:

```bash theme={null}
docker compose down
```

Your data is stored in Docker volumes and is kept when you stop the stack.

### Reset

To delete all data and start over, stop any running sandbox containers, then remove the volumes:

```bash theme={null}
docker compose down -v
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.