Installation

Agelo ships as three components you run together:

1. agelo-server — the .NET 8 backend that serves the HTTP API.
2. agelo-spa — the Angular single-page app the SAs and team members use.
3. agelo-mcp — the MCP server agents talk to.

For a typical install you also need MySQL 8+.

Prerequisites

• .NET 8 SDK (for agelo-server)
• Node.js 20+ and npm (for agelo-spa)
• Python 3.11+ (only for agelo-mcp — see the MCP installation guide)
• MySQL 8 (or compatible — MariaDB 10.11+ works)
• A reverse proxy if you are exposing the platform on the public internet (nginx, Caddy, Traefik)

Quick start (Docker Compose)

The simplest path is Docker Compose with the prebuilt GHCR images. Copy the Compose file from Run with Docker Compose into a folder and bring everything up:

docker compose pull
docker compose up -d

This starts MySQL, the API (http://localhost:3000), the SPA (http://localhost:4200), and the marketing/docs site (http://localhost:4173). That page also includes a build-from-source variant and the full .env reference. The MCP server runs separately — see the MCP installation guide.

Manual install

If you want to run without Docker, clone each repository and run it from source. The API creates its schema automatically on first boot, so you only need an empty MySQL 8 database and a user that can reach it.

# 1. Database — start MySQL 8 and create the database + user that the
#    API connection string points at.

# 2. API — agelo-server (bind :3000 so the SPA can reach it)
cd agelo-server
dotnet restore
ASPNETCORE_URLS=http://localhost:3000 dotnet run --project src/Agelo.Api

# 3. SPA — agelo-angular
cd ../agelo-angular
npm install
npm start

The SPA dev server runs on http://localhost:4200 and reaches the API at http://localhost:3000/api/v1.

Configuration

Configuration is read from environment variables. The most important ones are:

Variable	Purpose
AGELO_DB_CONNECTION	MySQL connection string.
AGELO_JWT_SECRET	HMAC key for signing SA tokens. Required, must be 32+ bytes.
AGELO_PUBLIC_URL	The URL the SPA and MCP server will use to reach the API.
AGELO_RATE_LIMIT_LOGIN	Per-IP login attempts per minute. Default 10.

See self-hosting for the complete list and production-tuning guidance.

Next steps

• Create your first organization: Your first org.
• Bring up a project with the default kanban template: Your first project.