# Quick Start Guide

Get the Agent Manager running with a single command using a dev container!

## Prerequisites[​](#prerequisites "Direct link to Prerequisites")

Ensure the following before you begin:

* **Docker** (Engine 26.0+ recommended) Allocate at least 8 GB RAM and 4 CPUs.

* **Mac users**: Use Colima for best compatibility

  ```
  colima start --vm-type=vz --vz-rosetta --cpu 4 --memory 8
  ```

## 🚀 Installation Using Dev Container[​](#-installation-using-dev-container "Direct link to 🚀 Installation Using Dev Container")

The quick-start includes a dev container with all required tools pre-installed (kubectl, Helm, K3d). This ensures a consistent environment across different systems.

### Step 1: Run the Dev Container[​](#step-1-run-the-dev-container "Direct link to Step 1: Run the Dev Container")

```
docker run --rm -it --name amp-quick-start \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --network=host \
  ghcr.io/wso2/amp-quick-start:v0.10.2
```

### Step 2: Run Installation Inside Container[​](#step-2-run-installation-inside-container "Direct link to Step 2: Run Installation Inside Container")

Once inside the container, run the installation script:

```
./install.sh
```

**Time:** \~15-20 minutes

This installs everything you need:

* ✅ K3d cluster
* ✅ OpenChoreo platform
* ✅ Agent Manager
* ✅ Full observability stack

## What Happens During Installation[​](#what-happens-during-installation "Direct link to What Happens During Installation")

1. **Prerequisites Check**: Verifies Docker, kubectl, Helm, and K3d are available
2. **K3d Cluster Setup**: Creates a local Kubernetes cluster named `amp-local`
3. **CoreDNS Configuration**: Applies CoreDNS custom configuration for OpenChoreo
4. **Machine ID Generation**: Generates machine IDs for Fluent Bit observability
5. **Cluster Prerequisites**: Installs Cert Manager, Gateway API CRDs, External Secrets Operator, and kgateway
6. **Secrets Setup**: Installs OpenBao for Workflow Plane and configures ClusterSecretStore with OpenBao backend
7. **OpenChoreo Installation**: Installs OpenChoreo Control Plane, Data Plane, Workflow Plane, and Observability Plane
8. **Gateway Operator**: Installs Gateway Operator with RBAC for WSO2 API Platform CRDs
9. **AMP Thunder Extension**: Installs WSO2 AMP Thunder Extension
10. **AI Gateway Extension**: Registers and installs WSO2 AI Gateway for LLM Provider management.
11. **Agent Management Platform**: Installs core platform (PostgreSQL, API, Console) and extensions (Secrets, Platform Resources, Observability, Build, Evaluation, Gateway)

## Access Your Platform[​](#access-your-platform "Direct link to Access Your Platform")

After installation completes, use the following endpoints to access the platform.

* **Console**: [`http://localhost:3000`](http://localhost:3000)

Login using the following credentials:

* **Username**: `admin`
* **Password**: `admin`

## Uninstall[​](#uninstall "Direct link to Uninstall")

**Platform only:**

```
./uninstall.sh
```