Ampache

A self-hosted music streaming application that provides a web interface and API for accessing your music library from anywhere. Supports multiple media formats, transcoding, and compatibility with Subsonic/Ampache API clients.

What You Can Do After Deployment

1. Visit your domain — the Ampache installer wizard will guide you through initial setup
2. Complete the setup wizard — configure the database (uses built-in SQLite), create your admin account, and set the music catalog path
3. Add a music catalog — point to the /media volume where your music files are stored
4. Browse and play — use the built-in web player to browse by artist, album, genre, or playlist
5. Connect mobile apps — use any Subsonic or Ampache API compatible client (DSub, Ultrasonic, Tempo, etc.)

Key Features

• Web-based music player with album art, lyrics, and visualizations
• Subsonic API and Ampache API compatible — works with dozens of mobile and desktop apps
• On-the-fly transcoding (MP3, OGG, FLAC, AAC, and more)
• Multi-user support with access control lists
• Podcast management and playback
• Video and live stream support
• Smart playlists, favorites, ratings, and play statistics
• Tag editor for managing metadata
• Share songs and playlists via public links

Volumes

• /media — mount your music library here; Ampache scans this directory for audio files
• /var/www/html/config — Ampache configuration files; persists settings across restarts

Configuration

The initial setup is handled through the web-based installer on first visit. After setup, configuration can be adjusted in the Ampache admin panel or by editing files in the config volume.

License

AGPL-3.0 — GitHub | Website