Skip to content

DOCKER.md

Latest commit

 

History

History
114 lines (89 loc) · 1.98 KB

DOCKER.md

File metadata and controls

114 lines (89 loc) · 1.98 KB

TreeRAG Docker Deployment Guide

🐳 Quick Start with Docker

Prerequisites

  • Docker Engine 20.10+
  • Docker Compose 2.0+
  • Gemini API Key

1. Setup Environment

# Create .env file
echo "GOOGLE_API_KEY=your_api_key_here" > .env

2. Build and Run

# Build and start all services
docker-compose up --build -d

# View logs
docker-compose logs -f

# Stop services
docker-compose down

3. Access Services

📦 Production Deployment

Environment Variables

# Backend
GOOGLE_API_KEY=your_api_key
USE_DEEP_TRAVERSAL=true
MAX_TRAVERSAL_DEPTH=5
MAX_BRANCHES_PER_LEVEL=3

# Frontend
NEXT_PUBLIC_API_BASE_URL=http://your-backend-url/api

Build for Production

# Build images
docker-compose build --no-cache

# Tag for registry
docker tag treerag-backend:latest your-registry/treerag-backend:v1.0
docker tag treerag-frontend:latest your-registry/treerag-frontend:v1.0

# Push to registry
docker push your-registry/treerag-backend:v1.0
docker push your-registry/treerag-frontend:v1.0

Scale Services

# Scale backend for high load
docker-compose up -d --scale backend=3

🔧 Development with Docker

# Run tests in container
docker-compose exec backend pytest tests/

# Shell access
docker-compose exec backend bash
docker-compose exec frontend sh

🛠 Troubleshooting

Container won't start

docker-compose logs backend
docker-compose logs frontend

Clear cache and rebuild

docker-compose down -v
docker-compose build --no-cache
docker-compose up -d

Check health

docker-compose ps
docker inspect --format='{{.State.Health}}' treerag-backend

📊 Monitoring

Resource Usage

docker stats

View logs

# All services
docker-compose logs -f

# Specific service
docker-compose logs -f backend
docker-compose logs -f frontend --tail=100