Koel
A personal music streaming server with a clean, modern web interface. Upload your music library and stream it from any browser.
What You Can Do After Deployment
- Visit your domain — log in with the default admin credentials:
[email protected] / KoelIsCool (change the password immediately)
- Upload music — place audio files in the
/music volume; Koel scans and indexes them automatically
- Play in browser — the built-in web player supports album art, playlists, and artist/album/genre browsing
- Create playlists — organize your music with smart playlists and favorites
Key Features
- Modern, responsive web UI built with Vue.js
- On-the-fly media scanning with metadata extraction
- Smart playlists, favorites, and recently played
- Multi-user support with individual libraries
- Supports MP3, FLAC, AAC, OGG, and other common audio formats
- Built-in equalizer and visualizer
- Last.fm scrobbling support
Volumes
/music — your music library; place audio files here for Koel to scan
/var/www/html/storage/search-indexes — search index data
Configuration
MEDIA_PATH — path to the music directory (set to /music by this template)
DB_CONNECTION — database driver (set to sqlite by this template)
MEMORY_LIMIT — PHP memory limit (default: 512M)
License
MIT — GitHub | Website