Koel

This happens when the post-scan event listeners do not run because required Laravel environment variables are missing, especially QUEUE_CONNECTION. Compare your .env file with .env.example and add the Laravel-specific variables from the bottom of the example file. For a standard Koel/Docker setup without a separate queue worker, ensure QUEUE_CONNECTION=sync. Then restart the container and rescan:

docker restart <koel-container>
docker exec -it <koel-container> php artisan koel:scan

After the scan, songs whose files have been removed from storage should be deleted from the songs table and disappear from the web interface.

Koel's default 50MB upload cap comes from PHP's upload_max_filesize and post_max_size settings. To raise it:

1. Copy .htaccess.example from the Koel repo root to .htaccess (if not already present).
2. Edit the values at the bottom, changing 50M to your desired limit, e.g.:

php_value upload_max_filesize 800M
   php_value post_max_size 800M

3. Save the file — Apache picks up .htaccess changes immediately, no restart needed.

Note: If you use the official Koel Docker image, its bundled php.ini already sets the limit to 800M, so align your .htaccess with that value. Also, if you proxy through Cloudflare, the free tier caps request/response sizes at 100MB — temporarily disable the Cloudflare proxy (DNS-only mode) when uploading files larger than that.