docker-compose.yml

# MusicFlow Docker Compose Configuration
# For local development and self-hosted production deployments

version: '3.8'

services:
  musicflow:
    build: .
    container_name: musicflow
    ports:
      - "8000:8000"
    environment:
      # Required: Set these in your environment or .env file
      - FLASK_ENV=${FLASK_ENV:-production}
      - BASE_URL=${BASE_URL:-http://localhost:8000}
      - SECRET_KEY=${SECRET_KEY:?SECRET_KEY is required}
      - STRAVA_CLIENT_ID=${STRAVA_CLIENT_ID:?STRAVA_CLIENT_ID is required}
      - STRAVA_CLIENT_SECRET=${STRAVA_CLIENT_SECRET:?STRAVA_CLIENT_SECRET is required}
      - SPOTIFY_CLIENT_ID=${SPOTIFY_CLIENT_ID:?SPOTIFY_CLIENT_ID is required}
      - SPOTIFY_CLIENT_SECRET=${SPOTIFY_CLIENT_SECRET:?SPOTIFY_CLIENT_SECRET is required}
      # Database: Use Supabase PostgreSQL (recommended) or leave empty for SQLite
      - DATABASE_URL=${DATABASE_URL:-}
      - DATABASE_PATH=${DATABASE_PATH:-/data/musicflow.db}
    volumes:
      # Only needed if using SQLite (DATABASE_URL is empty)
      - musicflow-data:/data
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:8000/')"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 10s

volumes:
  musicflow-data:
    driver: local

# ===========================================
# USAGE INSTRUCTIONS
# ===========================================
#
# 1. Copy .env.example to .env and fill in your values:
#    cp .env.example .env
#    # Edit .env with your API credentials and Supabase DATABASE_URL
#
# 2. Build and start:
#    docker-compose up -d --build
#
# 3. View logs:
#    docker-compose logs -f
#
# 4. Stop:
#    docker-compose down
#
# ===========================================
# DATABASE OPTIONS
# ===========================================
#
# Option 1: Supabase PostgreSQL (Recommended)
#   - Create project at https://supabase.com
#   - Get connection string from Settings > Database
#   - Set DATABASE_URL in .env
#
# Option 2: SQLite (local dev only)
#   - Leave DATABASE_URL empty
#   - Data stored in musicflow-data volume