> ## 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.

# Serve with ngrok

> Give the Docker Compose stack a public HTTPS URL with ngrok

Use ngrok to give the [Docker Compose](https://docs.openhands.dev/enterprise/docker-compose) stack a public HTTPS URL. You
don't need to open any ports.

## Prerequisites

* The [Docker Compose prerequisites](https://docs.openhands.dev/enterprise/docker-compose#prerequisites)
* ngrok, installed and connected to your ngrok account. Follow steps 1 and 2 of the
  [ngrok Agent CLI Quickstart](https://ngrok.com/docs/gateway/endpoints/agent-cli-quickstart).
* Your ngrok domain. Every ngrok account includes a free dev domain, such as
  `example-name.ngrok-free.app`. You can find it on the [Domains](https://dashboard.ngrok.com/domains)
  page of the ngrok dashboard.

## Install

**1. Clone the repository**

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

**2. Configure the stack**

Create a `.env` file in the `enterprise` directory. Replace `example-name.ngrok-free.app` with
your ngrok domain:

```bash .env theme={null}
WEB_HOST=example-name.ngrok-free.app
WEB_URL=https://example-name.ngrok-free.app
AGENT_CANVAS_LOCK_TO_CLOUD=https://example-name.ngrok-free.app
```

**3. Start the stack**

```bash theme={null}
docker compose up --wait
```

**4. Start ngrok**

```bash theme={null}
ngrok http 9043 --url https://example-name.ngrok-free.app
```

ngrok serves the stack at your domain while this command runs. Keep it running.

**5. Complete onboarding**

Open your ngrok URL and follow the onboarding flow to create your first user and configure
your LLM provider. On a free ngrok account, ngrok shows a warning page first. Click **Visit**
to continue.


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