---
sidebar_position: 1
---
# Quick Start Guide

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

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

  ```sh
  colima start --profile agent-manager \
    --vm-type=vz --vz-rosetta --network-address \
    --cpu 4 --memory 8
  ```

  The `agent-manager` profile isolates this install from your default Colima instance, and `--network-address` gives the VM a stable IP so the cluster survives network changes.

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

```bash
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.0.0-dev
```

### Step 2: Run Installation Inside Container

Once inside the container, run the installation script:

```bash
./install.sh
```

**Time:** ~15-20 minutes

This installs everything you need:
- ✅ K3d cluster
- ✅ OpenChoreo platform
- ✅ Agent Manager
- ✅ Full observability stack

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

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

**Platform only:**

```bash
./uninstall.sh
```
