fediversion/DEPLOY.md
fullsizemalt b4cddf41ea feat: Initialize Fediversion multi-band platform
- Fork elmeg-demo codebase for multi-band support
- Add data importer infrastructure with base class
- Create band-specific importers:
  - phish.py: Phish.net API v5
  - grateful_dead.py: Grateful Stats API
  - setlistfm.py: Dead & Company, Billy Strings (Setlist.fm)
- Add spec-kit configuration for Gemini
- Update README with supported bands and architecture
2025-12-28 12:39:28 -08:00

1.2 KiB

Deployment Guide

Prerequisites

  • Docker & Docker Compose
  • Git

Steps

  1. Clone the repository (if not already on the server):

    git clone <repo-url>
    cd elmeg
    
  2. Environment Variables: Create a .env file in the root directory (or rely on docker-compose.yml defaults for dev). For production, you should set:

    POSTGRES_USER=your_user
    POSTGRES_PASSWORD=your_password
    POSTGRES_DB=elmeg_db
    SECRET_KEY=your_production_secret_key
    
  3. Build and Run:

    docker-compose up --build -d
    
  4. Run Migrations: The backend container needs to run migrations.

    docker-compose exec backend alembic upgrade head
    
  5. Access the App:

    • Frontend: http://localhost:3000 (or your server IP)
    • Backend API: http://localhost:8000

Troubleshooting

  • Database Connection: Ensure the backend service can reach db. The DATABASE_URL in docker-compose.yml should match the postgres credentials.
  • API Connectivity: If the frontend (SSR) fails to fetch data, check INTERNAL_API_URL in docker-compose.yml. It should point to http://backend:8000.