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

# Install

> Install MeepaGateway on your machine or a server.

MeepaGateway is a single binary with no runtime dependencies (Docker is optional, for container mode tool execution).

## Install

<Tabs>
  <Tab title="curl">
    ```bash theme={null}
    curl -fsSL https://meepa.ai/install-meepagateway.sh | sh
    ```

    Auto-detects your OS and architecture, installs to `/usr/local/bin/meepagateway`.
  </Tab>

  <Tab title="Homebrew">
    ```bash theme={null}
    brew install bogpad/tap/meepagateway
    ```
  </Tab>

  <Tab title="Docker">
    ```bash theme={null}
    docker run -d \
      --name meepagateway \
      -p 63372:63372 \
      -v $(pwd)/config.yaml:/app/config.yaml:ro \
      -e ANTHROPIC_API_KEY="${ANTHROPIC_API_KEY}" \
      ghcr.io/bogpad/meepagateway:latest
    ```
  </Tab>
</Tabs>

## Verify

```bash theme={null}
meepagateway version
```

## Deploy to a VPS

### DigitalOcean (recommended)

One command — auto-detects SSH keys, uses a pre-baked snapshot if available (\~30 second boot), falls back to cloud-init on a fresh Ubuntu image (\~3 minute install):

```bash theme={null}
bash <(curl -fsSL https://meepa.ai/deploy-do-meepagateway.sh)
```

Pass your API key and password to skip the setup wizard:

```bash theme={null}
bash <(curl -fsSL https://meepa.ai/deploy-do-meepagateway.sh) \
  --anthropic-key "sk-ant-..." \
  --password "your-password"
```

Requires `doctl`: `brew install doctl && doctl auth init`

### Hetzner

```bash theme={null}
hcloud ssh-key list
# If empty: hcloud ssh-key create --name my-key --public-key-from-file ~/.ssh/id_ed25519.pub

IP=$(hcloud server create --name meepagateway \
  --image "$(hcloud image list -t snapshot -o columns=id,description | grep meepagateway- | sort -t- -k2 -V | tail -1 | awk '{print $1}')" \
  --type cx23 --ssh-key my-key \
  --user-data "$(curl -fsSL https://meepa.ai/cloud-init-image-meepagateway.sh)" \
  -o columns=public_net --no-header | awk '{print $1}')

echo "Dashboard: http://$IP:63372"
```

Requires `hcloud`: `brew install hcloud`

### Any VPS (cloud-init)

On any Ubuntu server:

```bash theme={null}
curl -fsSL https://meepa.ai/install-meepagateway.sh | sh
meepagateway
```

## Update

```bash theme={null}
meepagateway update
```

Or via the Captain Dashboard: **Settings > Update**.

Other methods:

```bash theme={null}
brew upgrade meepagateway
docker pull ghcr.io/bogpad/meepagateway:latest
```

## Uninstall

```bash theme={null}
meepagateway uninstall          # removes binary and skills catalog
meepagateway uninstall --purge  # also removes ~/.meepagateway/ agent data
```
