Skip to main content
Version: main

Docker quickstart

Docker Compose is useful when you want a server-like setup with separate services: nginx, PostgreSQL, Redis, and Qdrant. For a minimal local chat, use Local quickstart.

When to choose Docker Compose​

Use this path to test PostgreSQL, Qdrant-backed RAG and memory, nginx routing, persistent volumes, or container-based sandbox execution.

Services​

ServicePurpose
nginxServes the UI and proxies backend requests.
giga-agentGigaAgent backend and LangGraph API.
giga-agent-postgresApplication database.
langgraph-postgresLangGraph database.
langgraph-redisQueues, cache, and locks.
qdrantVector store for RAG and memory.

Nginx is published on http://localhost:8123.

Prepare environment​

cp .env.example .env

Set at least:

GIGA_AGENT_SECRET_KEY=<long-random-value>
GIGA_AGENT_HOST_PROJECT_PATH=<absolute-project-path>

GIGA_AGENT_HOST_PROJECT_PATH is needed for local Docker sandbox scenarios.

Run​

docker compose up --build

Or use:

make build
make up

Important limits​

Docker Compose uses data volumes, and the giga-agent container can mount the host Docker socket. Treat that socket as a privileged boundary.