Documentation

Everything you need
to deploy Ando.

Installation, configuration, plugin reference, and Admin API. Community Edition is Apache 2.0 — run it anywhere.

Quickstart

Up in 30 seconds.

shell
# Pull and run
docker pull ghcr.io/ando-ai-gateway/ando-ce:latest
docker run -d \
  -p 9080:9080 \
  -p 9180:9180 \
  ghcr.io/ando-ai-gateway/ando-ce:latest

# Add a route
curl -X PUT http://localhost:9180/apisix/admin/routes/1 \
  -H 'Content-Type: application/json' \
  -d '{
    "uri": "/api/*",
    "upstream": {
      "type": "roundrobin",
      "nodes": { "httpbin.org:80": 1 }
    }
  }'

Reference

01

Getting Started

Run Ando in under five minutes. Install from Docker or build from source. Configure your first upstream and route.

02

Configuration

Ando reads ando.yaml at startup. Every value can be overridden with ANDO_ environment variables. Supports standalone and etcd-backed cluster mode.

03

Plugin Reference

Plugins run in a deterministic pipeline: Rewrite → Access → BeforeProxy → HeaderFilter → BodyFilter → Log. Each plugin runs on the data-plane worker — no cross-thread overhead.

04

Admin API

RESTful control plane on port 9180. APISIX-compatible endpoints for routes, upstreams, consumers, services, and SSL certificates.

05

Architecture

Thread-per-core data plane on monoio. Shared-nothing workers with ArcSwap router reload. Admin API runs on a separate tokio thread. Zero hot-path locks.

06

Deployment

Production-ready Docker image. docker-compose for standalone and etcd cluster. Rolling config reload with zero downtime.