-
-
Notifications
You must be signed in to change notification settings - Fork 2.1k
Description
Read the Troubleshooting guide.
- I have read and followed the Troubleshooting guide
Reproduction steps
1.Title: Mobile app Home screen blank (white/grey) - /api/overview returns 500
Description:
The official Koel mobile app (Play Store) displays a completely blank/grey Home screen after login. Navigation tabs (Library, Search) work perfectly, music playback works, but the Home tab remains empty.
Environment:
Koel server: latest from GitHub repo
PHP: 8.2.29
Database: MySQL
Web server: Caddy v2.10.2 with PHP-FPM
Mobile: Android, Koel official app from Play Store
Investigation:
Accessing https://[server]/api/overview from a browser returns HTTP 500.
Laravel logs show the following error:
Route [login] not defined.
Symfony\Component\Routing\Exception\RouteNotFoundException
This occurs because the Authenticate middleware receives an unauthenticated request and tries to redirect to a login route that doesn't exist in Koel.
Tested PHP-FPM header transmission — the Authorization: Bearer header is correctly transmitted to PHP when explicitly sent.
Tested /api/overview directly via curl with a valid Bearer token — returns correct JSON response.
Koel works perfectly in desktop and mobile browsers with the same server configuration.
The personal_access_tokens table contains valid, non-expired tokens with recent last_used_at timestamps.
Conclusion:
The server is correctly configured and the API works when called with a proper Bearer token. The issue appears to be that the mobile app is not sending the Authorization header when requesting /api/overview on the Home screen, causing Laravel to treat the request as unauthenticated.
This may be a timing issue (app requests /api/overview before the token is set in the HTTP client), or the Home screen component is making the request without attaching the authentication header.
Steps to reproduce:
Install official Koel app from Play Store
Configure server URL and log in
Home tab appears blank/grey
Library and Search tabs work normally
Music playback works normally
2.
3.
4. ...
Expected behavior
Home Page
Actual behavior
Blank Screen, but library and search works
Logs
No response
Koel version
8.3.0
How did you install Koel?
Pre-compiled tar/zip archive
Additional information
- Server OS:
- PHP version:
- Database:
- Node version:
- Browser & device:
- Additional context: