Skip to main content

​
Welcome to GAIA Self-Hosting

Self-host GAIA with the CLI. The CLI handles setup, environment scaffolding, and run commands so you can get running quickly.

​
What runs

  • Web: Next.js
  • Backend: FastAPI
  • Databases/Infra: PostgreSQL, MongoDB, Redis, ChromaDB, RabbitMQ (via Docker)

​
Prerequisites

  • Node.js 20+ and one package manager (npm, pnpm, or bun)
  • Docker Engine 20.10+ and Compose v2+
  • 2+ CPU cores, 4GB+ RAM, 10GB+ disk (8GB+ RAM recommended)
  • API keys as needed (see Environment Variables)

​
Quick Start

1

Install the GAIA CLI

npm install -g @heygaia/cli
2

Initialize self-host mode

gaia init
In the setup wizard, choose Self-Host (Docker).
3

Start services

gaia start
4

Monitor and open GAIA

gaia status
gaia logs

​
Next Steps

Self-hosting requires ongoing maintenance and security updates.