Skip to main content

​
Welcome to GAIA Self-Hosting

Self-host GAIA with Docker Compose. Keep it simple: start with minimal env vars, add more only when you enable features.

​
What runs

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

​
Prerequisites

  • 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

Clone the repository

git clone https://github.com/theexperiencecompany/gaia.git
cd gaia
2

Set minimal env vars

Add a minimal apps/api/.env (see the “Minimal .env to boot locally” section in Environment Variables).
3

Start services

bash docker compose -f infra/docker/docker-compose.yml up -d
4

Open GAIA

​
Next Steps

Self-hosting requires ongoing maintenance and security updates.