Self-Hosting Guide

services:
  superglue:
    image: superglueai/superglue:latest
    ports:
      - "3000:3000"  # GraphQL API
      - "3001:3001"  # Web Dashboard
      - "3002:3002"  # REST API
    environment:
      - NODE_ENV=production
    env_file:
      - .env
    depends_on:
      - postgres
    restart: unless-stopped

  postgres:
    image: postgres:15-alpine
    ports:
      - "5432:5432"
    environment:
      - POSTGRES_DB=${POSTGRES_DB:-superglue}
      - POSTGRES_USER=${POSTGRES_USERNAME}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres_data:

# ==============================================================================
# ENDPOINTS AND AUTHENTICATION
# ==============================================================================

# Port for the superglue graphql server
GRAPHQL_PORT=3000
# Port to the superglue rest api (must be different than the graphql port)
API_PORT=3002

# Endpoint for the graphql api (used so the web dashboard knows where to find the server)
GRAPHQL_ENDPOINT=http://localhost:3000
# Endpoint for the rest api (not used at the moment)
API_ENDPOINT=http://localhost:3002

# Port for the web dashboard 
WEB_PORT=3001

# Authentication token for API access - needed for server to start
AUTH_TOKEN=your-secret-token

# Controls whether the workflow scheduler should run alongside Superglue.
# ⚠️ Important: Only enable this on a single instance. 
# Running multiple schedulers (e.g. in production or when using the same DB) 
# can cause conflicts.
START_SCHEDULER_SERVER=false


# ==============================================================================
# DATASTORE
# ==============================================================================

# Datastore type (redis or memory, file or postgres)
DATASTORE_TYPE=postgres

# If postgres: Database connection settings
POSTGRES_HOST=postgres
POSTGRES_PORT=5432
POSTGRES_USERNAME=superglue
POSTGRES_PASSWORD=your-secure-password
POSTGRES_DB=superglue
# when using a unsecured postgres db that does not support ssl, uncomment this:
POSTGRES_SSL=false



# ==============================================================================
# LLM PROVIDERS
# ==============================================================================

# AI Provider - OPENAI, OPENAI_LEGACY, GEMINI or ANTHROPIC
# best performance / price ratio right now is OpenAI with gpt-4.1
LLM_PROVIDER=OPENAI

# If GEMINI: Your Google API key
# You can get one here: https://aistudio.google.com/app/apikey
GEMINI_API_KEY=XXXXXXX
# Gemini model to use. We recommend gemini-2.5-flash
GEMINI_MODEL=gemini-2.5-flash

# If OPENAI: Your OpenAI API key
# You can get one here: https://platform.openai.com/api-keys
OPENAI_API_KEY=sk-proj-XXXXXXXX
# OpenAI model to use. Use gpt-4.1 for best results.
OPENAI_MODEL=gpt-4.1
# Optional: Set a custom OpenAI API URL (for self-hosted models or providers like fireworks.ai)
# For fireworks, use https://api.fireworks.ai/inference/v1
OPENAI_BASE_URL=https://api.openai.com/v1

# If ANTHROPIC: Your API KEY
# You can get one here: https://docs.anthropic.com/en/api/admin-api/apikeys/get-api-key
ANTHROPIC_API_KEY=sk-ant-XXXXXXX
# Anthropic model to use
ANTHROPIC_MODEL=claude-sonnet-4-20250514

# ==============================================================================
# MISC
# ==============================================================================

# Disable the welcome/onboarding screen for development
NEXT_PUBLIC_DISABLE_WELCOME_SCREEN=false

# Encryption settings
# Optional: Master key for encrypting stored credentials
# If not set, credentials will be stored in plaintext
# Generate a strong key: openssl rand -hex 32
# MASTER_ENCRYPTION_KEY=your-32-byte-encryption-key

docker-compose up --build

docker pull superglueai/superglue

docker run -d \
  --name superglue-redis \
  -v redis_data:/data \
  -p 6379:6379 \
  redis:6.2-alpine \
  redis-server --requirepass your-secure-password

docker run -d \
  --name superglue-postgres \
  -v postgres_data:/var/lib/postgresql/data \
  -p 5432:5432 \
  -e POSTGRES_DB=superglue \
  -e POSTGRES_USER=superglue \
  -e POSTGRES_PASSWORD=your-secure-password \
  postgres:15-alpine

docker run -d \
  --name superglue \
  --env-file .env \
  -p 3000:3000 \
  -p 3001:3001 \
  -p 3002:3002 \
  superglueai/superglue

curl http://localhost:3000/health

# superglue logs
docker logs superglue

# Redis logs
docker logs superglue-redis

# PostgreSQL logs
docker logs superglue-postgres

# Follow logs
docker logs -f superglue

docker pull superglueai/superglue:latest

docker-compose down
docker-compose up -d