クイックフィックス
「診断を実行する」
インストーラーにはスタックと一般的な設定ミスを確認するdoctorスクリプトが同梱されています。「Webインターフェースにアクセスできない」
- コンテナが実行中か確認します：
- ポートが正しくマッピングされているか確認します：
- Webコンテナのログを確認します：
「kodus-webログにEdge Runtimeエラーが表示される」
A Node.js API is used ... not supported in the Edge Runtimeのようなエラーが表示される場合（axiosのインポートトレースが伴うことが多い）、WebアプリのあちらがEdge Runtimeで実行されており、Node.js APIをサポートしていません。
- 最新の
kodus-webイメージに更新します（インストーラーを再実行するか、docker-compose pull kodus-webとdocker-compose up -dを実行）。 - ソースからビルドしている場合は、auth/サーバールートがNode.jsランタイムで実行されることを確認してください（
export const runtime = "nodejs"を設定し、それらのルートでruntime = "edge"を使用しないようにしてください）。 - コンテナを再ビルドして再起動します。
「Gitのwebhookが機能しない」
- ドメインの設定を確認します：
- Webhookの試行についてWebhooksのログを確認します：
- リバースプロキシの設定を確認します：
「データベース接続の問題」
- データベースコンテナの状態を確認します：
- データベースのログを確認します：
- データベース接続をテストします：
「vectorタイプが見つからないためマイグレーションが失敗した」
マイグレーション中に「type vector does not exist」エラーが発生した場合、PostgreSQLデータベースでpgvector拡張機能が有効になっていないためです。修正方法を以下に示します：- PostgreSQLデータベースに接続します：
- pgvector拡張機能を有効にします：
- 拡張機能を有効にした後、マイグレーションを再度実行します：
よくある問題
RabbitMQの問題
メッセージキューのエラーが表示される場合：- RabbitMQの状態を確認します：
-
http://localhost:15672の管理コンソールにアクセスして、キューと接続を確認します - 必要に応じてサービスを再起動します：
リソースの問題
サービスが遅くなったりクラッシュしたりする場合：- リソースの使用状況を確認します：
- コンテナの制限を確認します：
- 必要に応じてdocker-compose.ymlのリソース制限を調整します
サポートを受ける
サポートリクエストに含める内容
- 正確なエラーメッセージ
- 影響を受けたサービスの関連ログ
- デプロイ方法（CLI、VMなど）
- 問題を再現する手順