Koel logo

Koel

Personal music streaming server that works

Alternative to: spotify, apple music, youtube music


About Versions (100)

v7.11.0

2025-08-06

What’s Changed

  • You can now mark not just songs and episodes, but artists, albums, and podcasts as favorites. The albums, artists, and podcasts UI elements have been adapted to integrate this change — for example, clicking the “Show all / Show favorites only” button on the Album list screen will filter the list accordingly.
  • A couple of bugs have been squashed
  • A couple of improvements were added

Upgrade

Since the aforementioned changes unfortunately required a major modification to the database structure, BACK UP YOUR DATABASE before upgrading.

[!IMPORTANT] Back up your database!

Once you’ve made the database backup, follow the upgrade guide as per usual. Then, re-import the artists and albums search indexes:

php artisan scout:flush "App\Models\Album"
php artisan scout:import "App\Models\Album"
php artisan scout:flush "App\Models\Artist"
php artisan scout:import "App\Models\Artist" 

Oopsie?

If there’s any error during database migration, check storage/logs/laravel.log for the error details. If you can fix it yourself, great! Otherwise, restore the backup, reverse the upgrade, and file a report.