Skip to content

quick-start.mdx

Latest commit

 

History

History
86 lines (61 loc) · 2.86 KB

quick-start.mdx

File metadata and controls

86 lines (61 loc) · 2.86 KB
sidebar_position 1
title WSO2 Agent Manager Quick Start Guide
description Install WSO2 Agent Manager locally with a single command using the dev container quick start.

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

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:

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