Getting Started

Quick Start

git clone https://github.com/hahnavi/alga.git
cd alga
./setup.sh
docker compose up -d

This pulls pre-built images from GitHub Container Registry — no compilation required. Open http://localhost:3000. When no users exist in the database, Alga automatically redirects to the setup wizard — create the initial admin account by entering an email, password, and full name. The setup wizard is only available the first time, before any admin exists, so complete it before logging in.

After the initial admin account is created, your first login triggers the Onboarding Wizard, which walks you through changing the admin password, connecting integrations, and configuring your first routing rules.

Next Steps

Guide	What You'll Learn
Onboarding Wizard	Guided first-run setup for new installations
Installation & Setup	Docker Compose, manual install, production setup
First Steps Guide	Send test alerts, connect Grafana, explore features

Key Features to Explore

• Incidents — Full incident lifecycle with SLA tracking, escalation policies, and post-mortems
• Services — Service catalog with status tracking and dependency management
• On-Call — Multi-layer schedules with overrides and escalation policies
• Teams — Group users and link to escalation policies
• AI Investigation — Automated root cause analysis with Hermes/OpenClaw agents
• Knowledge Base — Shared notes for operators and agents with vector search
• Routing — Flexible alert routing to Slack, Mattermost, email, or voice

Explore by Topic

• Configuration — all environment variables
• Alerts — alert lifecycle and ingestion
• Incidents — incident management and SLA tracking
• Services — service catalog and dependencies
• Teams & On-Call — team management and on-call schedules
• Routing — route alerts to the right channels
• Integrations — connect Slack, Mattermost, or Twilio
• AI Investigation — set up automated investigation

Upgrading

git pull
docker compose pull
docker compose up -d

Alga auto-migrates the database schema on startup when POSTGRES_AUTO_MIGRATE=true (enabled by default in Docker Compose). Pin a specific version by setting ALGA_VERSION=v1.2.3 in .env.

For manual migrations: ./alga db migrate