Self-Hosting

Docker Setup

The easiest way to deploy Thalamus Labz projects.

Quick Start with Docker

All Thalamus Labz projects include Docker support out of the box. This is the recommended way to run in production.

Terminal

# Clone the repository
git clone https://github.com/thalamuslabz/SOPHIAClaw.git
cd SOPHIAClaw

# Copy environment file
cp .env.example .env

# Edit .env with your settings
nano .env

# Start with Docker Compose
docker-compose up -d

# View logs
docker-compose logs -f

Docker Compose Configuration

The included docker-compose.yml sets up all required services:

version: '3.8'

services:
  app:
    build: .
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
      - DATABASE_URL=postgres://user:pass@db:5432/sophiaclaw
    depends_on:
      - db
      - redis
    volumes:
      - ./data:/app/data

  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_USER: user
      POSTGRES_PASSWORD: pass
      POSTGRES_DB: sophiaclaw
    volumes:
      - postgres_data:/var/lib/postgresql/data

  redis:
    image: redis:7-alpine
    volumes:
      - redis_data:/data

volumes:
  postgres_data:
  redis_data:

Production Deployment

Production Checklist

• Change default passwords in .env
• Enable HTTPS with reverse proxy (nginx/traefik)
• Set up automated backups
• Configure log rotation
• Set up monitoring

← Architecture Environment →