Documentation

Getting Started

Vynl is a self-hosted music streaming platform with AI-powered discovery. It runs on any machine with Docker — a Raspberry Pi, an old laptop, a NAS, or a cloud VPS.

Prerequisites

• A machine running Docker (or Node.js 18+ for native install)
• Your music library (MP3, FLAC, M4A, AAC, OGG, Opus, WAV, WMA, AIFF)
• An Anthropic API key (for AI features — optional but recommended)

Quick Start (Docker)

Up and running in 3 commands:

git clone [email protected]:48Nauts-Operator/vynl-app.git
cd vynl-app
cp .env.example .env    # Edit with your paths and API keys
docker compose up -d

Open http://localhost:3101 in your browser. That's it.

System Requirements