​
Welcome to GAIA Self-Hosting

GAIA (General Purpose AI Assistant) can be easily self-hosted on your own infrastructure using Docker Compose. This gives you complete control over your data and allows you to customize the deployment to your specific needs.

​
Architecture Overview

GAIA consists of several components that work together:

  • Frontend: Next.js React application
  • Backend: FastAPI Python application
  • Database: PostgreSQL for structured data
  • Vector Database: ChromaDB for embeddings
  • Cache: Redis for caching and sessions
  • Message Queue: RabbitMQ for task processing
  • Document Storage: MongoDB for document metadata

​
Prerequisites

Before you begin, ensure you have:

​
Quick Start

1

Clone the Repository

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

Set Up Environment Variables

See the Environment Variables guide for details.

3

Start the Application

docker compose up -d

This will start all services in the background.

4

Access GAIA

Open your browser and navigate to:

​
Next Steps

Environment Variables

Configure all required API keys and settings

Docker Setup

Detailed Docker configuration and deployment

Infisical Setup

Secure secret management with Infisical

Self-hosting requires technical knowledge and ongoing maintenance.