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

# Deploy the ACP Handler

> Use StateSet Deploy to ship the ACP handler to production.

# Deploy the ACP Handler

StateSet Deploy can build and host the ACP handler on managed Kubernetes.

## 1) Add a Deploy Button

```markdown theme={null}
[![Deploy to StateSet](https://deploy.stateset.cloud.stateset.app/button.svg)](https://deploy.stateset.cloud.stateset.app/deploy?repo=stateset/stateset-acp-handler)
```

## 2) (Optional) Add `stateset.yaml`

```yaml theme={null}
name: stateset-acp-handler
description: ACP handler service

build:
  dockerfile: Dockerfile
  context: .

runtime:
  port: 8080
  health_check: /health
  readiness_check: /ready
```

## 3) Configure Environment Variables

Use `stateset.yaml` or the deploy UI to set required environment variables for the handler. Refer to the handler README for the latest list.

## 4) Deploy

Click the deploy button, authenticate with GitHub, and wait for the deployment to complete.

Your app will be available at:

```
https://{app-name}.{slug}.cloud.stateset.app
```

## Related Documentation

* [ACP Handler README](/stateset-acp-handler/README)
* [StateSet Deploy](/stateset-deploy/README)