トラブルシューティング
対象:管理者
補足
データベースの再作成や接続設定の変更など、影響の大きい作業は、お手元のデータを確認のうえ、不明な場合はサポートにご相談ください。
起動・アクセス
画面が開かない
DigitalBase は単一プロセスで ポート 8000 で動作します。
db start # Bare Metal を起動(前景にログが出ます)
docker logs -f digitalbase-app # Docker のログ確認
ブラウザで http://localhost:8000 を開きます。LAN 公開やホスト名設定はネットワーク / 動作環境を参照してください。
ポートが使用中
症状: address already in use :::8000
lsof -i :8000
kill -9 <PID>
# または
db stop
データベース関連
pgvector 拡張が無効
症状: RAG が使えない / pgvector に関する警告
pgvector 拡張を導入します。拡張の有効化はアプリ起動時に自動で行われます。
| OS | コマンド |
|---|---|
| macOS | brew install pgvector |
| Linux | sudo apt install postgresql-16-pgvector(PG のバージョンに合わせる) |
補足
Windows で非管理者のままインストールすると pgvector が無効化され、RAG が使えません。管理者で再実行するか、Docker 版を利用してください。
PostgreSQL が起動していない
| OS | コマンド |
|---|---|
| macOS | brew services start postgresql@16 |
| Linux | sudo systemctl start postgresql |
| Windows | サービスマネージャーで「postgresql-x64-16」を起動 |
PostgreSQL が停止していると、初期化(bootstrap)がスキップされます。起動後に DigitalBase を再起動してください。
接続情報を変更したい
既存の PostgreSQL / RDS 等に向ける場合は .env の DATABASE_URL を変更します。ユーザー・データベースの作成は事前に DBA 作業が必要です。構成にお困りの場合はサポートにご相談ください。
Ollama 関連
Ollama が起動しない
ollama serve # 手動起動
ollama serve &>/dev/null & # バックグラウンド起動
モデルが表示されない
ollama pull gemma3:4b # チャット用
ollama pull nomic-embed-text # RAG 用
ollama list # 一覧確認
ログの確認
- Bare Metal:
db startを実行した前景にログが出力されます。 - Docker:
docker logs -f digitalbase-app