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​
- Prerequisites Check: Verifies Docker, kubectl, Helm, and K3d are available
- K3d Cluster Setup: Creates a local Kubernetes cluster named
amp-local - CoreDNS Configuration: Applies CoreDNS custom configuration for OpenChoreo
- Machine ID Generation: Generates machine IDs for Fluent Bit observability
- Cluster Prerequisites: Installs Cert Manager, Gateway API CRDs, External Secrets Operator, and kgateway
- Secrets Setup: Installs OpenBao for Workflow Plane and configures ClusterSecretStore with OpenBao backend
- OpenChoreo Installation: Installs OpenChoreo Control Plane, Data Plane, Workflow Plane, and Observability Plane
- Gateway Operator: Installs Gateway Operator with RBAC for WSO2 API Platform CRDs
- AMP Thunder Extension: Installs WSO2 AMP Thunder Extension
- AI Gateway Extension: Registers and installs WSO2 AI Gateway for LLM Provider management.
- 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
Login using the following credentials:
- Username:
admin - Password:
admin
Uninstall​
Platform only:
./uninstall.sh