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

# StateSet Deploy

> One-click deployment service for commerce handlers, agents, and iCommerce apps on managed Kubernetes.

# StateSet Deploy

StateSet Deploy builds and hosts commerce handlers and iCommerce applications on managed Kubernetes infrastructure. Connect your GitHub repository and deploy with a single click.

## Features

* **One-click deploy** — Push to GitHub, Deploy builds and ships automatically.
* **Docker builds** — Builds container images from your repo's Dockerfile.
* **Managed Kubernetes** — Runs on production-grade K8s with autoscaling and health checks.
* **HTTPS by default** — TLS certificates provisioned automatically.
* **Custom domains** — Point your own domain at a deployment.
* **Persistent storage** — Attach volumes for databases, file uploads, or caches.
* **Environment secrets** — Inject API keys and credentials securely.
* **Deployment logs** — Stream build and runtime logs in the console.

## Supported Deployment Types

| Type               | Description                                                   | Example                                                |
| ------------------ | ------------------------------------------------------------- | ------------------------------------------------------ |
| **ACP Handler**    | Agentic Commerce Protocol handler for conversational checkout | [Deploy ACP Handler](/stateset-deploy-acp-handler)     |
| **ChatGPT App**    | ChatGPT plugin powered by StateSet Response                   | [Deploy ChatGPT App](/stateset-deploy-chatgpt-app)     |
| **iCommerce App**  | Full iCommerce application with agent sandbox                 | [iCommerce Quickstart](/stateset-icommerce-quickstart) |
| **Custom Service** | Any Docker container with an HTTP endpoint                    | —                                                      |

## How It Works

1. **Connect** — Link your GitHub repository in the StateSet Console.
2. **Configure** — Set environment variables, resource limits, and domain.
3. **Deploy** — StateSet builds a Docker image, pushes it to the registry, and creates a Kubernetes deployment.
4. **Monitor** — View build logs, runtime metrics, and health status in the console.

## Quickstart

### Deploy from the Console

1. Go to **Dashboard > Deployments > New Deployment**.
2. Select your GitHub repository.
3. Configure environment variables (e.g., `STATESET_API_KEY`).
4. Click **Deploy**.

### Deploy via CLI

```bash theme={null}
stateset deploy --repo https://github.com/your-org/your-app \
  --env STATESET_API_KEY=$STATESET_API_KEY \
  --domain your-app.stateset.cloud
```

## Architecture

```
GitHub Push → Build (Docker) → Registry → Kubernetes Deployment
                                              │
                                              ├── HTTPS Ingress
                                              ├── Autoscaling
                                              ├── Health Checks
                                              └── Persistent Storage
```

## Related Documentation

* [Deploy README](/stateset-deploy/README)
* [Deploy ACP Handler](/stateset-deploy-acp-handler)
* [Deploy ChatGPT App](/stateset-deploy-chatgpt-app)
* [Cloud API Reference](/cloud-api-reference/overview)