トラブルシューティング
データベースの再作成・接続設定の変更など影響の大きい作業は、データを確認してから行う。
起動・アクセス
画面が開かない
プロセスが起動していない。起動してログを確認し、http://localhost:8000 を開く。
Bare Metal は次のコマンドで起動する。
db start
Docker のログは次のコマンドで確認する。
docker compose logs -f app
LAN 公開はネットワーク / 動作環境を見る。
ポートが使用中
address already in use :::8000 が出たら、使用中のプロセスを停止する。
lsof -i :8000 && kill -9 <PID>
db stop でも停止できる。
推論エンジン（WSL2）
WSL2 で vLLM が RuntimeError: UVA is not available で起動しない
2026-09-12 より後のバージョンは自動で回避する。それ以前のバージョンは .env に VLLM_WSL2_ENABLE_PIN_MEMORY=1 を追加して再起動する（vllm #47387）。
データベース関連
pgvector 拡張が無効
RAG 画面に「ナレッジは停止中です (pgvector 未導入)」と出たら、pgvector を入れる。OS ごとのパッケージは事前の環境設定を見る。
アプリの DB ユーザーで有効化できない時は、次の順に進める。
- 管理画面 > 登録管理 の RAG 検索強化で「有効化」を押す。
- 表示される SQL を DBA が superuser で実行する。
- もう一度「有効化」を押す。
Windows で非管理者のままインストールすると pgvector が無効になる。管理者で再実行するか、Docker 版を使う。
PostgreSQL が起動していない
初期化がスキップされる。PostgreSQL を起動して DigitalBase を再起動する。
macOS は次のコマンドで起動する。postgresql@17 は入れたバージョンに合わせる。
brew services start postgresql@17
Linux は次のコマンドで起動する。
sudo systemctl start postgresql
Windows はサービス postgresql-x64-<バージョン>（postgresql で始まる名前）を起動する。
接続情報を変更したい
.env の DATABASE_URL を変更する。ユーザー・データベースは事前に DBA が作成する。
Ollama 関連
Ollama が起動しない
手動で起動する。
ollama serve
バックグラウンドで動かす時は次のコマンドを使う。
ollama serve &>/dev/null &
モデルが表示されない
モデルが未取得。チャット用モデルを取得する。次のコマンドは例。
ollama pull gemma3:4b
RAG の埋め込みモデルを取得する。既定の OLLAMA_EMBED_MODEL はこのモデル。
ollama pull embeddinggemma
取得できたか確認する。
ollama list
GPU が認識されない / 1 枚しか使われない
枚数を確認する。
nvidia-smi --query-gpu=index,name --format=csv,noheader
- 枚数が出ない → ドライバを入れ直す。
- 1 枚しか使われない →
.envのENGINE_TENSOR_PARALLELが1固定でないか確認する（既定の空欄は自動。高度な設定）。
管理画面で GPU の温度・電力が「—」の場合は本ページ下部の「DCGM exporter が起動しない」を見る。
ログの確認
Bare Metal（Linux の systemd の機） は次のコマンドで見る。
db logs
Bare Metal（macOS など systemd の無い機） は db start を実行した端末に出る。db logs は無い。
Docker は次のコマンドで見る。
docker compose logs -f app
推論サーバー（vLLM / SGLang） はインストール先の logs/ に出る。管理画面のモデル管理にも失敗理由を表示する。
アップデート はインストール先の update.log に出る。
- 更新に失敗したら同じコマンドを再実行する。
- 前のバージョンへ戻す時はバージョンを指定して再実行する（起動・運用 › アップデート）。
クラウド GPU コンテナでインストールが止まる
root 実行・sudo なし・systemd なしの環境向け。
sudo: command not found
root から実行する。
su postgres -c "psql -d postgres -c \"CREATE USER digitalbase WITH PASSWORD 'digitalbase';\""
CREATE DATABASE digitalbase OWNER digitalbase; も同様に実行する。
psql: could not connect
PostgreSQL を手動で起動する。
pg_ctlcluster $(ls /etc/postgresql | sort -V | tail -1) main start
nvcc: command not found（vLLM 版）
次のコマンドを実行し、.env にも追記する。
export PATH=/usr/local/cuda/bin:$PATH
ビルド依存が足りない（vLLM 版）
次のパッケージを入れる。
apt install -y build-essential python3-dev ffmpeg ninja-build
DCGM exporter が起動しない（libdcgm.so.4 not found）
DCGM v4 を入れて、サービスを有効にする。
apt install -y datacenter-gpu-manager-4-core datacenter-gpu-manager-4-cuda13 datacenter-gpu-manager-exporter
systemctl enable --now nvidia-dcgm nvidia-dcgm-exporter
再構成でデータが消える
DATABASE_URL を外部または永続ボリューム上の PostgreSQL に向ける。
SSH を切るとプロセスが落ちる
tmux new -s digitalbase の中で db start を実行する。