DOCKER.md

Docker Deployment Guide

This guide explains how to deploy Digital Galatea using Docker.

Quick Start

Using Pre-built Image from Docker Hub

docker run -d \
  --name digital-galatea \
  -p 7860:7860 \
  -e DEEPSEEK_API_KEY=your_deepseek_api_key \
  -e INFLECTION_AI_API_KEY=your_inflection_api_key \
  codejediondockerhub/digital-galatea:latest

Using Docker Compose

1. Create a .env file with your API keys (see .env.example)
2. Run:

   docker-compose up -d
   

Building the Image

Build Locally

docker build -t digital-galatea:latest .

Build and Tag for Docker Hub

docker build -t codejediondockerhub/digital-galatea:latest .

Publishing to Docker Hub

1. Login to Docker Hub

   docker login
   

2. Tag the Image (if not already tagged)

   docker tag digital-galatea:latest codejediondockerhub/digital-galatea:latest
   

3. Push to Docker Hub

   docker push codejediondockerhub/digital-galatea:latest
   

4. Push with Version Tag (optional)

   docker tag digital-galatea:latest codejediondockerhub/digital-galatea:v1.0.0
   docker push codejediondockerhub/digital-galatea:v1.0.0
   

Environment Variables

Required Variables

• DEEPSEEK_API_KEY - Your DeepSeek API key
• INFLECTION_AI_API_KEY - Your Inflection AI API key

Optional Variables

• AZURE_TEXT_ANALYTICS_KEY - Azure Text Analytics key
• AZURE_TEXT_ANALYTICS_ENDPOINT - Azure endpoint URL
• PORT - Server port (default: 7860)

Running the Container

Basic Run

docker run -d \
  --name digital-galatea \
  -p 7860:7860 \
  -e DEEPSEEK_API_KEY=your_key \
  -e INFLECTION_AI_API_KEY=your_key \
  codejediondockerhub/digital-galatea:latest

With Environment File

docker run -d \
  --name digital-galatea \
  -p 7860:7860 \
  --env-file .env \
  codejediondockerhub/digital-galatea:latest

With Volume for Persistence

docker run -d \
  --name digital-galatea \
  -p 7860:7860 \
  -v $(pwd)/data:/app/data \
  --env-file .env \
  codejediondockerhub/digital-galatea:latest

Container Management

View Logs

docker logs digital-galatea
docker logs -f digital-galatea  # Follow logs

Stop Container

docker stop digital-galatea

Start Container

docker start digital-galatea

Remove Container

docker rm digital-galatea

Restart Container

docker restart digital-galatea

Health Checks

The container includes a health check endpoint. You can verify it's running:

curl http://localhost:7860/health

Troubleshooting

Container Won't Start

1. Check logs: docker logs digital-galatea
2. Verify environment variables are set correctly
3. Ensure port 7860 is not already in use

API Errors

1. Verify API keys are correct
2. Check network connectivity
3. Review application logs for specific error messages

NLTK Data Download

NLTK data is downloaded automatically on first container start. This may take a few minutes. Check logs to see progress.

Production Considerations

1. Use Environment Files: Store sensitive keys in .env files (not in version control)
2. Resource Limits: Set appropriate memory and CPU limits
3. Restart Policy: Use --restart unless-stopped for automatic restarts
4. Health Checks: Monitor the /health endpoint
5. Logging: Configure log rotation and monitoring

Example production run:

docker run -d \
  --name digital-galatea \
  --restart unless-stopped \
  -p 7860:7860 \
  --memory="2g" \
  --cpus="2" \
  --env-file .env \
  codejediondockerhub/digital-galatea:latest