DigitalBase Docs (β版)製品サイト

トラブルシューティング

対象:管理者
補足

データベースの再作成や接続設定の変更など、影響の大きい作業は、お手元のデータを確認のうえ、不明な場合はサポートにご相談ください。

起動・アクセス

画面が開かない

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コマンド
macOSbrew install pgvector
Linuxsudo apt install postgresql-16-pgvector(PG のバージョンに合わせる)
補足

Windows で非管理者のままインストールすると pgvector が無効化され、RAG が使えません。管理者で再実行するか、Docker 版を利用してください。

PostgreSQL が起動していない

OSコマンド
macOSbrew services start postgresql@16
Linuxsudo systemctl start postgresql
Windowsサービスマネージャーで「postgresql-x64-16」を起動

PostgreSQL が停止していると、初期化(bootstrap)がスキップされます。起動後に DigitalBase を再起動してください。

接続情報を変更したい

既存の PostgreSQL / RDS 等に向ける場合は .envDATABASE_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