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
- Frontend: 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
backend/.env (see the “Minimal .env to boot locally” section
in Environment Variables).3
Start services
bash docker compose up -d 4
Open GAIA
- Frontend: http://localhost:3000 - Backend API: http://localhost:8000
Next Steps
- Configure additional features as you need them: see Environment Variables
- For advanced options: see Docker Setup