DigitalBase Docs

環境変数 / 設定一覧

DigitalBase の挙動は .env ファイルの環境変数で設定します。多くの項目は管理画面の 環境変数 タブからも編集できます(「本体を再起動」で反映)。管理画面の一覧にはよく使う項目のみ表示されます。全項目のリファレンスは本ページです。

対象:管理者必要権限:サーバ管理権限
注意

[機密] が付いた項目(API キー・パスワード・JWT secret など)は秘匿情報です。リポジトリやログに残さず、本番では既定値を必ず変更してください。

補足

既定値が ""(空文字)の項目は 未設定が既定で、空のままでも動作します。空のときに実際にどう振る舞うか(フォールバック先の既定)は、各行の「説明」内の「= 空なら…」を参照してください。

設定項目は全 186 件です。

データベース

変数既定値説明
DATABASE_URLpostgresql://digitalbase:digitalbase@localhost:5432/digitalbase[機密] PostgreSQL 接続文字列 (= 通常 install スクリプトが自動設定)

LLM Backend

変数既定値説明
LLM_BACKENDollamaLLM 推論 backend (= ollama | vllm | none)

LLM (vLLM)

変数既定値説明
VLLM_RERANK_BASE_URL""vLLM reranker server の base URL (= 空なら rerank 無効)
VLLM_CHAT_MODELQwen/Qwen3-4BvLLM chat model 名 (= HuggingFace ID、default は 4B / 32K context / ~8GB VRAM)
VLLM_EMBED_MODELintfloat/multilingual-e5-large-instructvLLM RAG 用 embedding model 名
VLLM_VISION_MODEL""vLLM vision model 名 (= 空なら無効)
VLLM_AUTO_STARTfalsetrue で起動時に vLLM server も auto-spawn
VLLM_TENSOR_PARALLEL1vLLM tensor parallel size (= GPU 数)
VLLM_EXTRA_ARGS_CHAT""chat server 起動の追加引数 (スペース区切り)。tool calling は要設定 例: --enable-auto-tool-choice --tool-call-parser hermes
VLLM_PYTHON(自動検出)vLLM サーバを起動する Python 実行パス (= 既定は venv を自動検出。合わない場合のみ設定)

エンドポイントプール・GPU メモリ割当・API key などの運用向け変数は、ページ下部の「その他(詳細チューニング)」内 LLM (vLLM) 運用 を参照してください。

RAG

変数既定値説明
RERANK_ENABLEDfalseRAG reranker を有効化 (= 要 VLLM_RERANK_BASE_URL)
RERANK_TOP_N30rerank 前に集める候補数 (= 2段検索の1段目)
SESSION_RAG_TOP_K8chat 添付 RAG の取得チャンク数 (= 多いほど文脈厚い)

LLM (Ollama)

変数既定値説明
OLLAMA_BASE_URLhttp://localhost:11434Ollama サーバの base URL
OLLAMA_API_KEY""[機密] proxy 経由認証時のみ設定 (= 通常空)
OLLAMA_EMBED_MODELembeddinggemmaRAG 用 embedding model 名 (= Ollama tag)
OLLAMA_NUM_PARALLEL""Ollama 同時並列実行数 (= 空ならデフォルト)
OLLAMA_AUTO_STARTfalsetrue で起動時に Ollama daemon を host で auto-spawn (= LLM_BACKEND=ollama 時のみ)
OLLAMA_CONTEXT_LENGTH""(廃止予定: LLM_CONTEXT_LENGTH を使用) Ollama context window 長

LLM (共通)

変数既定値説明
LLM_CONTEXT_LENGTH""LLM context window 上限 (= 両 backend 共通、空ならモデル default)
MAX_OUTPUT_TOKENS65536チャットの出力 max_tokens の上限 (= UI スライダ最大値、両 backend 共通)
DEFAULT_MAX_OUTPUT_TOKENS16384max_tokens 未指定時の出力上限 (= 明示指定はこの値に縛られない)
LLM_REQUEST_TIMEOUT900AI op の LLM 1リクエストの timeout 秒 (大きめ推奨。ai_agent は長時間動く前提)

ライセンス

変数既定値説明
LICENSE_FILE_PATHOS / 環境により自動ライセンスファイル path (= 通常 OS 別に自動検出)
API_LICENSE_URLhttp://localhost:8000ライセンス検証 / 更新 API endpoint
PUBLIC_KEY_PATHpublic_key.pemライセンス署名検証用 RSA 公開鍵 path

API サーバ

変数既定値説明
API_PORT8000FastAPI 待受ポート
API_HOST0.0.0.0FastAPI bind アドレス
MAX_TOOL_ROUNDS30Tool calling の最大 round 数 (= chat/service.py、LLM 再帰呼出の上限)
MAX_PDF_PAGES500PDF アップロード時の最大ページ数
EXECUTE_PYTHON_TIMEOUT300execute_python tool の実行 timeout 秒

リソース上限

変数既定値説明
TOOL_FILE_READ_MAX_CHARS500000read_file tool の最大文字数 (= 超過分は切り捨て)
TOOL_CSV_MAX_ROWS100000CSV 読込/整形の最大行数
TOOL_REMOTE_MAX_BYTESOS / 環境により自動リモート(S3/Drive/SharePoint等)ファイル取得の最大バイト数
TOOL_LOCAL_INLINE_MAX_BYTESOS / 環境により自動ローカルファイル inline 読込の最大バイト数
PYTHON_OUTPUT_MAX_CHARS100000execute_python の出力テキスト最大文字数
PYTHON_DF_PREVIEW_ROWS1000execute_python の DataFrame プレビュー最大行数
TOOL_DESCRIBE_MAX_BYTES20971520describe_file の画像解析に渡す最大バイト数 (= 20MB)

認証 / セッション

変数既定値説明
JWT_SECRET(自動生成)[機密] JWT 署名 secret (= 空なら起動ごとに自動生成、再起動でセッション失効。installer が .env に生成値を設定)
JWT_EXPIRE_DAYS365JWT 有効期限 (日)
AUTH_MODElocal認証モード: local | ldap | oidc

LDAP / AD 連携

変数既定値説明
LDAP_HOST""AD/LDAP サーバ host
LDAP_PORT389LDAP port (= LDAPS は 636)
LDAP_USE_SSLfalsetrue で LDAPS / StartTLS
LDAP_BASE_DN""検索 base DN (例: DC=company,DC=local)
LDAP_USER_DN_FORMAT{username}@company.localuser bind DN format
LDAP_BIND_DN""search 用 bind account DN
LDAP_BIND_PASSWORD""[機密] bind account password

OIDC (Entra ID)

変数既定値説明
OIDC_CLIENT_ID""Entra ID アプリの client ID
OIDC_CLIENT_SECRET""[機密] Entra ID アプリの client secret
OIDC_TENANT_ID""Azure tenant ID
OIDC_ISSUER""OIDC issuer URL (= 空なら tenant から自動)
OIDC_REDIRECT_URIhttp://localhost:8000/auth/oidc/callbackOIDC callback URL

ファイル / 外部ディレクトリ

変数既定値説明
FILES_DIROS / 環境により自動user file 保存先 (= myfile/shared dir 配置 root)
EXTERNAL_DATA_DIRS""外部 dir アクセス許可 (= "/path1,label=/path2" 形式、既定は読み書き両方)。末尾 :ro で読み取り専用 mount

Cloud LLM

変数既定値説明
OPENAI_API_KEY""[機密] OpenAI API key (= 設定すると GPT モデルが選択肢に追加)
OPENAI_BASE_URLhttps://api.openai.com/v1OpenAI API base URL (= proxy 経由なら変更)
ANTHROPIC_API_KEY""[機密] Anthropic API key (= Claude モデル有効化)
GEMINI_API_KEY""[機密] Google Gemini API key

Web 検索

変数既定値説明
WEB_SEARCH_ENABLEDfalsetrue で chat の Web 検索 tool 有効化
WEB_SEARCH_ENGINEduckduckgoduckduckgo | searxng
WEB_SEARCH_SEARXNG_URLhttp://localhost:8888SearXNG instance URL (= WEB_SEARCH_ENGINE=searxng 時)
WEB_SEARCH_MAX_RESULTS51 検索あたりの最大結果数

OAuth (SaaS 連携)

変数既定値説明
OAUTH_CALLBACK_BASE_URL""OAuth callback の base URL (= 公開 URL に合わせる、空ならリクエスト URL から導出)
OAUTH_UI_REDIRECT/pipeline/connectionsOAuth 完了後の UI redirect path
OAUTH_ENCRYPTION_KEY""[機密] OAuth token 暗号化 key (= Fernet、install 時に自動生成)
GOOGLE_OAUTH_CLIENT_ID""Google OAuth client ID (= Google Drive 連携用、 Google Cloud Console で発行)
GOOGLE_OAUTH_CLIENT_SECRET""[機密] Google OAuth client secret (= Google Drive 連携用)
MS_OAUTH_CLIENT_ID""Microsoft OAuth client ID (= OneDrive / SharePoint 連携用、 Azure AD で発行)
MS_OAUTH_CLIENT_SECRET""[機密] Microsoft OAuth client secret (= OneDrive / SharePoint 連携用)
DROPBOX_OAUTH_CLIENT_ID""Dropbox OAuth app key (= Dropbox 連携用、 Dropbox App Console で発行)
DROPBOX_OAUTH_CLIENT_SECRET""[機密] Dropbox OAuth app secret (= Dropbox 連携用)
BOX_OAUTH_CLIENT_ID""Box OAuth client ID (= Box 連携用、 Box Developer Console で発行)
BOX_OAUTH_CLIENT_SECRET""[機密] Box OAuth client secret (= Box 連携用)

Vision / Office画像化

変数既定値説明
SOFFICE_PATH""soffice 実行ファイルのパス (= 空なら PATH と ~/.local/db/tools から自動検出。Office画像化)
SOFFICE_TIMEOUT180Office 文書 → PDF 変換 1 回のタイムアウト秒

音声 / Whisper

変数既定値説明
WHISPER_MODEL""Whisper モデルサイズ: tiny | base | small | medium | large (= 空ならデフォルト)

その他(詳細チューニング)

既定のままで問題ない詳細設定です。管理画面には既定で表示されませんが、必要時に .env に書けば上書きできます(すべて数値・秒・件数などのチューニング値)。

SQL / データ接続

変数既定値説明
SQL_POOL_SIZE2SQL Query 機能の connection pool size (= 同時利用が多い環境は引き上げ)
SQL_POOL_MAX_OVERFLOW3SQL Query 機能の pool overflow 上限
SQL_POOL_TIMEOUT10SQL Query 機能の pool 取得待ち秒
SQL_POOL_RECYCLE300SQL Query 機能の connection 再生成間隔秒
SQL_CONNECT_TIMEOUT10外部DB接続のタイムアウト秒 (= 到達不能DBで固まらない上限。pg/mysql系)
SQL_STATEMENT_TIMEOUT_MS300001クエリの実行タイムアウト(ms、0=無効)。重いクエリを有界化 (= PostgreSQLのみ)
SQL_EXACT_COUNT_MAX100000行数を実COUNT(*)で数える上限 (= 超過は統計から概算し、大テーブルのフルスキャンを回避)
PIPELINE_SQL_POOL_SIZE5pipeline SQL connector の connection pool size
PIPELINE_SQL_MAX_OVERFLOW10pipeline SQL connector の pool overflow 上限
DB_POOL_SIZE10メイン DB engine の connection pool サイズ
DB_POOL_MAX_OVERFLOW20メイン DB engine の pool 超過許容数
DB_POOL_RECYCLE1800メイン DB engine の connection 再生成間隔秒 (= stale 接続対策)
SQL_ENGINE_CACHE_MAX20外部 SQL 接続 engine キャッシュの上限数 (= 超過時は古い engine を dispose)
SQL_LLM_TIMEOUT600AI SQL 生成の LLM timeout 秒 (= EOS が出ずハングした時の cap)

RAG (pgvector / HNSW索引)

変数既定値説明
HNSW_M16pgvector HNSW の m (= ノードあたり最大近傍数。大=recall↑/メモリ↑/構築遅)
HNSW_EF_CONSTRUCTION64HNSW 構築時の候補幅 (= 大=索引品質↑/構築遅)
HNSW_EF_SEARCH100HNSW 検索時 ef_search の下限 (= 実効は候補数との max。大=recall↑/遅)
HNSW_ITERATIVE_SCANrelaxed_orderpgvector 0.8+ の iterative_scan (off/relaxed_order/strict_order。フィルタ検索の過剰除外を回避)

ツール / Python 実行

変数既定値説明
TOOL_SEARCH_FILES_MAX_MATCHES50search_files tool の最大 match 行数
TOOL_SEARCH_SNIPPET_MAX_CHARS200search_files の match 行 snippet 最大文字数
TOOL_LIST_FILES_MAX_ENTRIES200list_files の共有 root 直下 file 列挙上限
TOOL_GLOB_MAX_MATCHES1000glob tool の最大 match 数
TOOL_GREP_MAX_MATCHES500grep tool の最大 match 行数
TOOL_SHARED_DIR_READ_MAX_BYTES32768共有 dir 専用 read tool の inline 読込上限バイト
TOOL_PREVIEW_ROWS50pipeline operator 実行 tool の結果 preview 行数
TOOL_VECTOR_SEARCH_MAX_TOP_K10vector_search tool の top_k 上限
TOOL_QUERY_DATASET_MAX_ROWS1000query_dataset tool の返却行数上限
CHAT_TABLE_MAX_ROWS500chat の SQL 結果テーブル表示の最大行数
PYTHON_SESSION_TTL1800execute_python session の保持 TTL 秒
PYTHON_SESSION_MAX30execute_python session の同時保持数上限
GATEWAY_QUERY_MAX_ROWS10000gateway data query の返却行数上限
TOOL_STREAM_TEXT_THRESHOLD96tool loop 中、tool_call delta 無しでこの文字数を超えたら最終回答とみなし text を stream 開始する閾値
TOOL_APPROVAL_WAIT_SEC600tool 実行承認の最大待ち秒 (= 超過は deny 扱い)
TOOL_KEEPALIVE_INTERVAL10chat stream の keepalive 間隔秒 (= 承認待ち/LLM 無音/tool 実行中の heartbeat)
TOOL_LOOP_GUARD_MAX_REPEATS4同一 tool call の反復をこの回数で打ち切る loop guard
TOOL_RETRY_ATTEMPTS3call_api_operator の rate-limit retry 回数 (指数バックオフ)
CLOUD_OP_MAX_ATTEMPTS3cloud 系 pipeline operator の HTTP retry 回数
MCP_DISCOVERY_TIMEOUT10MCP server の tool 一覧取得 timeout 秒
MCP_TOOL_TIMEOUT30MCP tool 実行の timeout 秒

RAG / 検索

変数既定値説明
SESSION_RAG_CHUNK_SIZE800chat 添付 RAG の chunk 文字数
SESSION_RAG_CHUNK_OVERLAP100chat 添付 RAG の chunk 重なり文字数
SESSION_RAG_MAX_CHUNKS5000chat 添付 RAG の in-memory 保持 chunk 上限 (= 超過は古い順に破棄)
RAG_DEFAULT_TOP_K10RAG 検索の既定取得 chunk 数 (= top_k 未指定時)
RAG_HYBRID_CANDIDATE_FACTOR6hybrid 検索の候補 pool 倍率 (= top_k × この値)
RAG_HYBRID_CANDIDATE_MIN30hybrid 検索の候補 pool 最小数
RAG_RRF_K60RRF 融合の rank 平滑化定数 (= 大きいほど上位偏重が緩む)
RERANK_TIMEOUT30reranker 呼出の timeout 秒
RAG_MAX_PAGES200RAG 取込 / vision 抽出の PDF 最大ページ数
BOT_RAG_TOP_K8chat の bot RAG 検索既定 top_k (= request 未指定時)
RAG_DEFAULT_MIN_SIMILARITY0.35chat の bot RAG 類似度しきい値既定 (= request 未指定時)
UPLOAD_PROGRESS_TTL_SEC3600RAG 取込進捗エントリの保持秒数 (= ポーリング用 in-memory レジストリの TTL)

パイプライン

変数既定値説明
PIPELINE_AI_TEXT_MAX_CHARS32000pipeline AI op の group text 切り詰め文字数 (= context 超過防止)
PIPELINE_MAX_ITERATIONS10000pipeline 実行 loop の安全上限 (= 暴走 guard)
PIPELINE_AI_AGENT_MAX_CONCURRENCY8ai_agent op の並列実行上限 (= DB pool / vLLM 負荷保護)

LLM (vLLM) 運用

変数既定値説明
VLLM_BASE_URLhttp://localhost:8080vLLM chat server の base URL
VLLM_EMBED_BASE_URLhttp://localhost:8081vLLM embedding server の base URL (= 別 server)
VLLM_VISION_BASE_URL""vLLM vision server URL (= 空なら chat server 兼用)
VLLM_RERANK_MODELBAAI/bge-reranker-v2-m3reranker モデル (cross-encoder, 多言語)
HF_HUB_OFFLINE""1 で HuggingFace download 禁止 (= air-gapped / オフライン稼働、model 事前 download 必須)
VLLM_CHAT_ENDPOINTS""chat vLLM endpoint pool (= カンマ区切り URL、空なら VLLM_BASE_URL)
VLLM_EMBED_ENDPOINTS""embed vLLM endpoint pool (= カンマ区切り URL、空なら VLLM_EMBED_BASE_URL)
VLLM_VISION_ENDPOINTS""vision vLLM endpoint pool (= カンマ区切り URL、空なら VLLM_VISION_BASE_URL)
DCGM_PORT9400DCGM exporter port (= GPU 監視。host は endpoint から導出、温度/電力を best-effort で overlay)
VLLM_API_KEY""[機密] proxy 経由認証時のみ設定 (= 通常空)
VLLM_EMBED_API_KEY""[機密] embed server 用 API key
VLLM_RERANK_API_KEY""[機密] reranker server 用 API key (= 通常空)
VLLM_GPU_MEMORY_UTILIZATION_CHAT""chat server の GPU memory 利用率 (= 0.0-1.0)
VLLM_GPU_MEMORY_UTILIZATION_EMBED""embed server の GPU memory 利用率
VLLM_GPU_MEMORY_UTILIZATION_VISION""vision server の GPU memory 利用率
VLLM_MAX_MODEL_LEN""(廃止予定: LLM_CONTEXT_LENGTH を使用) vLLM context window 上限
VLLM_REASONING_PARSER""reasoning parser 指定 (= Qwen3 thinking mode は 'qwen3')
VLLM_EXTRA_ARGS_EMBED""embed server 起動の追加引数 (スペース区切り)
VLLM_EXTRA_ARGS_VISION""vision server 起動の追加引数 (スペース区切り)
TRANSFORMERS_OFFLINE""1 で transformers lib もオフライン化 (= HF_HUB_OFFLINE と併用推奨)
HF_HOME""HuggingFace cache dir 上書き (= 空なら ~/.cache/huggingface)

LLM / gateway

変数既定値説明
GATEWAY_REQUEST_TIMEOUT300gateway (OpenAI 互換 API) 1 リクエストの timeout 秒
GATEWAY_HISTORY_LIMIT10gateway chat の会話履歴保持ターン数
CLOUD_MAX_TOKENS_CAP64000Anthropic 呼出の max_tokens 上限
CLOUD_DEFAULT_MAX_TOKENS4096Anthropic 呼出で max_tokens 未指定時の既定値
LLM_MIN_OUTPUT_TOKENS256context 超過エラー判定前に確保する最小出力 token 数
LLM_CONTEXT_MARGIN_TOKENS64max_tokens を context に収める際の安全 margin token 数
VLLM_MODELS_TTL30served model 一覧の cache TTL 秒
VLLM_START_MAX_RETRIES3auto-start 時の vLLM 起動 retry 回数
VLLM_START_RETRY_DELAY10vLLM 起動 retry の待機秒
VLLM_STARTUP_TIMEOUT3600vLLM server の ready 待ち timeout 秒 (= 大型 model は load が長い)
CLOUD_LLM_TIMEOUT300Cloud LLM (OpenAI/Anthropic/Gemini) の HTTP timeout 秒 (chat/tool 呼出共通)
CLOUD_EMBED_TIMEOUT60Cloud embedding の HTTP timeout 秒
GATEWAY_IMAGE_FETCH_TIMEOUT10gateway chat の外部画像 URL 取得 timeout 秒
CONV_MEMORY_MAX_SESSIONS500in-memory 会話キャッシュの最大セッション数 (= 超過時は古い順に破棄)

ファイル / 外部ストレージ

変数既定値説明
FILE_STREAM_CHUNK_BYTES65536file connector streaming 読込の chunk バイト数
CONNECTOR_PAGE_SIZE_GDRIVE1000Google Drive 一覧取得の page size
CONNECTOR_PAGE_SIZE_ONEDRIVE200OneDrive 一覧取得の page size
CONNECTOR_PAGE_SIZE_SHAREPOINT200SharePoint 一覧取得の page size
CONNECTOR_PAGE_SIZE_BOX1000Box 一覧取得の page size

Vision / Web 検索 / 認証 / 運用

変数既定値説明
VISION_PDF_DPI300PDF→画像の解像度(dpi)。大判図面は高め(300-400)、通常文書は200程度
VISION_MAX_TILED_PARTS17タイル分割 vision の 1 リクエスト画像 part 上限 (= token 爆発防止)
WEB_SEARCH_SNIPPET_MAX_CHARS300Web 検索結果 snippet の最大文字数
WEB_SEARCH_REGIONjp-jpDuckDuckGo の地域指定 (kl パラメータ。日本語結果を優先)
WEB_SEARCH_FETCH_PAGES3検索上位から本文を取得するページ数 (0 で snippet のみ)
WEB_SEARCH_PAGE_MAX_CHARS4000取得した本文をコンテキストに渡す最大文字数 (1ページあたり)
OAUTH_REFRESH_THRESHOLD300OAuth token の期限前 refresh 開始秒
LDAP_TIMEOUT10LDAP 接続 / 応答の timeout 秒 (= 遅い AD 環境では引き上げ)
ADMIN_BACKUP_TIMEOUT1800DB backup (pg_dump) の timeout 秒 (= 大規模 DB は引き上げ)
ADMIN_RESTORE_TIMEOUT900DB restore (pg_restore) の timeout 秒
TRANSCRIBE_FFMPEG_TIMEOUT600音声変換 (ffmpeg) の timeout 秒 (= 長時間録音は引き上げ)
LOG_DB_QUEUE_SIZE5000DB log handler の queue 上限
LOG_DB_BATCH_SIZE100DB log handler の batch insert 件数
LOG_DB_FLUSH_INTERVAL1.0DB log handler の flush 間隔秒
VISION_TILE_OVERLAP0.12vision タイル分割のオーバーラップ比率 (= 境界跨ぎの読み落とし防止)
VISION_TILE_MIN_EDGE1000vision タイル分割を行う最小短辺 px (= これ未満の画像は分割しない)
WEB_SEARCH_TIMEOUT10Web 検索 (DuckDuckGo/SearXNG) の HTTP timeout 秒
OAUTH_HTTP_TIMEOUT30OAuth token 交換/更新の HTTP timeout 秒

関連