Docker環境でKoelのミュージックサーバを構築

2025-05-072025-05-17

今回は、KoelのDockerリポジトリを使用してミュージックサーバを構築した際のトラブルシューティングについてご紹介します。初めての試みでいくつかの問題に直面しましたが、解決策を見つける過程で多くの学びがありました。

はじめに

Dockerを利用することで、複雑な依存関係や環境設定の手間を省き、KoelのようなWebアプリケーションを手軽にデプロイできます。しかし、実際の運用では細かな設定ミスや環境依存の問題に遭遇することも少なくありません。私が直面したのは、ブラウザ上で「500 Internal Server Error」が表示されるという問題でした。

初期トラブル：500 Internal Server Errorの発生

初回の環境構築後、ブラウザにアクセスすると「500 Internal Server Error」が表示され、正常にページが読み込まれませんでした。このエラーはサーバ側の設定エラーやファイルの不整合が原因で発生することが多く、ログを確認するなどの調査が必要でした。

.envファイルの不足に気づく

GitHub上の情報（こちらのissue）を参照する中で、原因の一つとして.envファイルの不在が指摘されていました。
対策:

Dockerコンテナ内の/var/www/html/.envにホスト側の.envファイルをマッピングする設定を行いました。
例：.env:/var/www/html/.env
この設定により、環境変数の設定が反映され、アプリケーション側でも正しい設定ファイルを参照できるようになりました。

Koelの初期化失敗とデータベース移行エラー

.envファイルの対応後、コンテナに入り、Koelの初期化コマンド

# docker exec --user www-data -it koel bash
www-data@e48566cd2562:~/html$ php artisan koel:init --no-assets
************************************
*     KOEL INSTALLATION WIZARD     *
************************************

As a reminder, you can always install/upgrade manually following the guide at https://docs.koel.dev

  Clearing caches ........................................................................................................................ 40ms DONE
  .env file exists -- skipping ................................................................................................................ DONE
  Generating app key ...................................................................................................................... 7ms DONE
  Using app key: base64:2XQMjmcpY.. ........................................................................................................... DONE
  Migrating database .................................................................................................................... 263ms FAIL

   ERROR  Oops! Koel installation or upgrade didn't finish successfully.

   ERROR  Please check the error log at storage/logs/laravel.log and try again.

   ERROR  For further troubleshooting, visit https://docs.koel.dev/troubleshooting.

   ERROR  😥 Sorry for this. You deserve better.

を実行しましたが、"Migrating database" の段階で失敗してしまいました。この段階ではマイグレーション処理中に何らかのエラーが発生しており、データベースのセットアップが正常に行われていませんでした。