Koel

[MickLesk]

Name of the Script

Koel

Script Type

CT (LXC Container)

📋 Script Details

Koel is a personal music streaming server written in Vue.js and Laravel. It allows you to stream your own music collection from anywhere with a modern, beautiful web interface.

Features:

Web-based audio player with visualizations
Smart playlists and queue management
Multi-user support
YouTube video integration
Last.fm scrobbling
Mobile-friendly responsive design
Media upload via browser or direct file placement
Default credentials: admin@koel.dev / KoelIsCool

[github-actions]

The koel script is ready for testing:
bash -c "$(curl -fsSL https://github.com/community-scripts/ProxmoxVED/raw/main/ct/koel.sh)"
Default credentials:
Username: admin@koel.dev
Password: KoelIsCool

Media files should be placed in /opt/koel_media
Database credentials are stored in ~/koel.creds
Music library is scanned hourly via cron job

Note: This is not in the official repo yet—it's just a dev version! After merging into ProxmoxVE, it will need to be recreated.

[DragoQC]

🧩 Using Advanced Install on node dragoqc
💡 PVE Version 8.4.14 (Kernel: 6.8.12-16-pve)
🖥️ Operating System: debian
🌟 Version: 13
📦 Container Type: Unprivileged
🆔 Container ID: 101
🏠 Hostname: koel
💾 Disk Size: 8 GB
🧠 CPU Cores: 2
🛠️ RAM Size: 2048 MiB
🌉 Bridge: vmbr0
📡 IPv4: dhcp
📡 IPv6: auto
🗂️ FUSE Support: yes
📡 TUN/TAP Support: yes
📦 Nesting: Enabled
GPU Passthrough: no
📦 Timezone: America/Toronto
🔍 Verbose Mode: yes

Uploading trough the UI didnt worked. im on debian maybe thats an app problem.
I connected trough ssh uploaded 2 files (mp3 and mp4)
The two worked

Update using : nano ~/.koel and changing values worked
Music still there after update

Tested default install. worked 100%
Tested default install on proxmox 9.1.1 worked also

[github-actions]

A PR has been created for koel: community-scripts/ProxmoxVE#9972

[michelroegl-brunner]

Merged with #9972 in ProxmoxVE