Skip to main content
Version: v0.10.x

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

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

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

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​

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​

  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.

Login using the following credentials:

  • Username: admin
  • Password: admin

Uninstall​

Platform only:

./uninstall.sh