Installation

Playlist Pipeline can be self-hosted for users who want full control over their data and infrastructure.

Requirements

• Docker and Docker Compose
• PostgreSQL 15+
• A Spotify Developer Application

Spotify Developer Setup

1. Go to the Spotify Developer Dashboard
2. Create a new application
3. Note your Client ID and Client Secret
4. Add your redirect URI (e.g., http://localhost:3000/auth/spotify/callback)

Quick Start with Docker Compose

docker-compose.yml

services:
  api:
    image: ghcr.io/your-org/plpl-api:latest
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgres://postgres:postgres@db:5432/plpl
      - SPOTIFY_CLIENT_ID=your-client-id
      - SPOTIFY_CLIENT_SECRET=your-client-secret
    depends_on:
      - db

  scheduler:
    image: ghcr.io/your-org/plpl-scheduler:latest
    environment:
      - DATABASE_URL=postgres://postgres:postgres@db:5432/plpl
      - API_URL=http://api:3000
    depends_on:
      - api

  worker:
    image: ghcr.io/your-org/plpl-worker:latest
    environment:
      - SPOTIFY_CLIENT_ID=your-client-id
      - SPOTIFY_CLIENT_SECRET=your-client-secret
      - SCHEDULER_URL=http://scheduler:3001
    depends_on:
      - scheduler

  db:
    image: postgres:15
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_DB=plpl
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

Running

docker compose up -d

The API will be available at http://localhost:3000.

Next Steps

See Configuration for detailed configuration options.