🌍 環境変数の設定
概要
Open WebUIは、アプリケーションのさまざまな側面をカスタマイズおよび構成するための幅広い環境変数を提供します。このページは、利用可能なすべての環境変数の包括的なリファレンスとして機能し、それらのタイプ、デフォルト値、および説明を提供します。
新しい変数が導入されるたびに、このページは更新され、構成オプションの拡大を反映するようになります。
このページはOpen WebUIのリリースバージョンv0.6.9に対応していますが、環境変数の詳細な説明やオプション、デフォルト、説明の改善に向けて作業が進行中です。
PersistentConfig
環境変数に関する重要な注意点
Open WebUIを初めて起動する際、すべての環境変数は均等に扱われ、アプリケーションを構成するために使用できます。ただし、PersistentConfig
としてマークされた環境変数の値は保持され、内部に保存されます。
初回起動後、コンテナを再起動すると、PersistentConfig
環境変数は外部の環境変数の値を使用しなくなり、代わりに内部に保存された値を使用します。
対照的に、通常の環境変数は各再起動時に引き続き更新され、適用されます。
Open WebUI内部から直接PersistentConfig
環境変数の値を更新することができ、これらの変更は内部に保存されます。この設定により、外部の環境変数とは独立してこれらの構成設定を管理できます。
PersistentConfig
環境変数は以下のドキュメントで明確にマークされていますので、その動作を理解することができます。
アプリ/バックエンド
以下の環境変数はbackend/open_webui/config.py
によって使用され、Open WebUIの起動設定を提供します。一部の変数は、Open WebUIを直接実行するかDockerを使用するかに応じて異なるデフォルト値を持つ場合があります。
ログに関する環境変数の詳細については、ログのドキュメントをご覧ください。
一般
WEBUI_URL
- タイプ:
str
- デフォルト:
http://localhost:3000
- 説明: Open WebUIがアクセス可能なURLを指定します。現在は検索エンジンのサポートに使用されます。
- 保持: この環境変数は
PersistentConfig
変数です。
ENABLE_SIGNUP
- タイプ:
bool
- デフォルト:
True
- 説明: ユーザーアカウント作成を切り替えます。
- 保持: この環境変数は
PersistentConfig
変数です。
ENABLE_LOGIN_FORM
- タイプ:
bool
- デフォルト:
True
- 説明: メールアドレス、パスワード、サインイン、
ENABLE_OAUTH_SIGNUP
がTrueに設定されている場合の「または」という要素を切り替えます。 - 保持: この環境変数は
PersistentConfig
変数です。
この設定は、ENABLE_OAUTH_SIGNUPが使用され、Trueに設定されている場合にのみFalse
に設定する必要があります。そうしないと、ログインができなくなります。
DEFAULT_LOCALE
- タイプ:
str
- デフォルト:
en
- 説明: アプリケーションのデフォルトロケールを設定します。
- 保持: この環境変数は
PersistentConfig
変数です。
DEFAULT_MODELS
- タイプ:
str
- デフォルト: 空文字列( )、
None
- 説明: デフォルトの言語モデルを設定します。
- 保持: この環境変数は
PersistentConfig
変数です。
DEFAULT_USER_ROLE
- タイプ:
str
- オプション:
pending
: 新しいユーザーは管理者によって手動でアクティブ化されるまで保留中。user
: 新しいユーザーは通常のユーザー権限で自動的にアクティブ化されます。admin
: 新しいユーザーは管理者権限で自動的にアクティブ化されます。
- デフォルト:
pending
- 説明: 新しいユーザーに割り当てられるデフォルトの役割を設定します。
- 保持: この環境変数は
PersistentConfig
変数です。
PENDING_USER_OVERLAY_TITLE
- タイプ:
str
- デフォルト: 空文字列( )
- 説明: 保留中のユーザーオーバーレイのカスタムタイトルを設定します。
- 保持: この環境変数は
PersistentConfig
変数です。
PENDING_USER_OVERLAY_CONTENT
- タイプ:
str
- デフォルト: 空文字列( )
- 説明: 保留中のユーザーオーバーレイのカスタムテキストコンテンツを設定します。
- 保持: この環境変数は
PersistentConfig
変数です。
ENABLE_CHANNELS
- タイプ:
bool
- デフォルト:
False
- 説明: チャネルサポートを有効または無効にします。
- 保持: この環境変数は
PersistentConfig
変数です。
WEBHOOK_URL
- タイプ:
str
- 説明: Discord/Slack/Microsoft Teamsとの統合のためのWebhookを設定します。
- 永続性: この環境変数は
PersistentConfig
変数です。
ENABLE_ADMIN_EXPORT
- 型:
bool
- デフォルト:
True
- 説明: 管理者ユーザーがデータをエクスポートできるかどうかを制御します。
ENABLE_ADMIN_CHAT_ACCESS
- 型:
bool
- デフォルト:
True
- 説明: 管理者ユーザーがすべてのチャットにアクセスできるようにします。
ENABLE_USER_WEBHOOKS
- 型:
bool
- デフォルト:
True
- 説明: ユーザーのWebhookを有効化または無効化します。
- 永続性: この環境変数は
PersistentConfig
変数です。
RESPONSE_WATERMARK
- 型:
str
- デフォルト: 空文字列 ( )
- 説明: チャットでメッセージをコピーする際に含まれるカスタムテキストを設定します。例:
"このテキストはAI生成です"
-> メッセージをコピーすると「このテキストはAI生成です」が追加されます。 - 永続性: この環境変数は
PersistentConfig
変数です。
THREAD_POOL_SIZE
- 型:
int
- デフォルト:
0
- 説明: FastAPI/AnyIOのブロッキング呼び出しに対するスレッドプールサイズを設定します。デフォルトでは(0が設定された場合)FastAPI/AnyIOは
40
スレッドを使用します。大規模なインスタンスや多数の同時ユーザーの場合、THREAD_POOL_SIZE
を増やしてブロッキングを防ぐ必要がある場合があります。
SHOW_ADMIN_DETAILS
- 型:
bool
- デフォルト:
True
- 説明: インターフェースで管理者ユーザーの詳細を表示するかどうかを切り替えます。
- 永続性: この環境変数は
PersistentConfig
変数です。
ADMIN_EMAIL
- 型:
str
- 説明:
SHOW_ADMIN_DETAILS
によって表示される管理者メールを設定します。 - 永続性: この環境変数は
PersistentConfig
変数です。
ENV
- 型:
str
- オプション:
dev
-/docs
でFastAPIのAPIドキュメントを有効にします。prod
- 複数の環境変数を自動的に設定します。
- デフォルト:
- バックエンドデフォルト:
dev
- Dockerデフォルト:
prod
- バックエンドデフォルト:
- 説明: 環境設定。
ENABLE_PERSISTENT_CONFIG
- 型:
bool
- デフォルト:
True
- 説明:
False
に設定されると、すべてのPersistentConfig
変数は通常の変数として扱われます。
CUSTOM_NAME
- 型:
str
- 説明:
WEBUI_NAME
を設定しますが、api.openwebui.comのメタデータをポールします。
WEBUI_NAME
- 型:
str
- デフォルト:
Open WebUI
- 説明: メインのWebUI名を設定します。上書きされた場合は
(Open WebUI)
を追加します。
PORT
- 型:
int
- デフォルト:
8080
- 説明: Open WebUIを実行するためのポートを設定します。
Pythonを使用してopen-webui serve
コマンドでアプリケーションを実行している場合、PORT
構成を使用してポートを設定することはできません。その代わりに、コマンドライン引数として--port
フラグを使用して直接指定する必要があります。例:
open-webui serve --port 9999
これにより、Open WebUIがポート9999
で実行されます。このモードでは、PORT
環境変数は無視されます。
ENABLE_REALTIME_CHAT_SAVE
- 型:
bool
- デフォルト:
False
- 説明: 有効化されると、最大限のデータ永続性を確保するため、ストリーミングチャットデータの各チャンクをリアルタイムでデータベースに保存します。この機能は、堅牢なデータ回復を提供し、正確なセッション追跡を可能にします。ただし、データベースに保存することによる遅延があり、レイテンシが増加します。この機能を無効化すると、パフォーマンスが向上し、遅延を減少させることができますが、システム障害やクラッシュ時にデータ損失のリスクがあります。アプリケーションの要件と受け入れ可能なトレードオフに基づいて使用してください。
BYPASS_MODEL_ACCESS_CONTROL
- 型:
bool
- デフォルト:
False
- 説明: モデルアクセス制御を回避します。
WEBUI_BUILD_HASH
- 型:
str
- デフォルト:
dev-build
- 説明: リリース用ビルドのGit SHAを識別するために使用されます。
WEBUI_BANNERS
- 型:
list
ofdict
- デフォルト:
[]
- 説明: ユーザーに表示するバナーのリスト。バナー形式の例:
[{"id": "string", "type": "string [info, success, warning, error]", "title": "string", "content": "string", "dismissible": false, "timestamp": 1000}]
- 永続性: この環境変数は
PersistentConfig
変数です。
.env
ファイルでこの環境変数を設定する場合、引用符をエスケープするために値全体をダブルクォートで囲み、内部引用符にエスケープされた引用符(\"
)を使用してください。例:
WEBUI_BANNERS="[{\"id\": \"1\", \"type\": \"warning\", \"title\": \"あなたのメッセージは保存されています。\", \"content\": \"あなたのメッセージは保存され、人間によってレビューされる可能性があります。LLMは幻覚を起こしやすいので、情報源を確認してください。\", \"dismissible\": true, \"timestamp\": 1000}]"
USE_CUDA_DOCKER
- 型:
bool
- デフォルト:
False
- 説明: NVIDIA CUDAのサポートでDockerイメージをビルドします。ローカルWhisperおよび埋め込みのGPUアクセラレーションを有効にします。
EXTERNAL_PWA_MANIFEST_URL
- 型:
str
- デフォルト: 空文字列 ( )(デフォルトで
None
が設定されています)。 - 説明: 完全なURL (例: https://path/to/manifest.webmanifest) として定義されている場合、/manifest.jsonへのリクエストは外部のマニフェストファイルを使用します。定義されていない場合、デフォルトのmanifest.jsonファイルが使用されます。
ENABLE_TITLE_GENERATION
- 種類:
bool
- デ フォルト:
True
- 説明: チャットタイトル生成を有効または無効にします。
- 永続性: この環境変数は
PersistentConfig
変数です。
LICENSE_KEY
- 種類:
str
- デフォルト:
None
- 説明: 使用するライセンスキーを指定します(エンタープライズユーザーのみ)。
- 永続性: この環境変数は
PersistentConfig
変数です。
SSL_ASSERT_FINGERPRINT
- 種類:
str
- デフォルト: 空文字列( )、デフォルトとして
None
が設定されています。 - 説明: 使用するSSLアサートフィンガープリントを指定します。
- 永続性: この環境変数は
PersistentConfig
変数です。
DEFAULT_PROMPT_SUGGESTIONS
- 種類:
list
ofdict
- デフォルト:
[]
(組み込みのデフォルトプロンプト提案を使用することを意味します) - 説明: プロンプト提案のリスト。プロンプト提案のフォーマットは次の通りです:
[{"title": ["Title part 1", "Title part 2"], "content": "prompt"}]
AIOHTTP クライアント
AIOHTTP_CLIENT_TIMEOUT
- 種類:
int
- デフォルト:
300
- 説明: AIOHTTPクライアントのタイムアウト期間を秒単位で指定します。これには、OllamaやOpenAIエンドポイントへの接続などが含まれます。
これは、クライアントが応答を待つ最大時間です。
空文字列( )を設定すると、タイムアウトがNone
に設定され、タイムアウトが無効になり、
クライアントは無期限に待つことができます。
AIOHTTP_CLIENT_TIMEOUT_MODEL_LIST
- 種類:
int
- デフォルト:
10
- 説明: モデルリストを取得するためのタイムアウトを秒単位で設定します。ネットワーク遅延により、モデルリストを正常に取得するために長いタイムアウトが必要な場合に役立ちます。
AIOHTTP_CLIENT_TIMEOUT_MODEL_LISTはデフォルトで10秒に設定されており、Web UIを開く際に必要なすべての接続が利用可能であることを保証するのに役立ちます。この期間は、ネットワーク遅延が高い場合でもモデルリストを取得するのに十分な時間を許します。より短いタイムアウトを希望する場合は、この値を下げることができますが、ネットワーク状況に応じて一部の接続が切断される可能性があることに注意してください。
AIOHTTP_CLIENT_TIMEOUT_OPENAI_MODEL_LIST
- 種類:
int
- 説明: モデルリストを取得するためのタイムアウトを秒単位で設定します。ネットワーク遅延が長い場合に成功する可能性を上げるために役立ちます。
ディレクトリ
DATA_DIR
- 種類:
str
- デフォルト:
./data
- 説明: アップロード、キャッシュ、ベクトルデータベースなどのデータ保存用のベースディレクトリを指定します。
FONTS_DIR
- 種類:
str
- 説明: フォントのディレクトリを指定します。
FRONTEND_BUILD_DIR
- 種類:
str
- デフォルト:
../build
- 説明: フロントエンドのビルド済みファイルの場所を指定します。
STATIC_DIR
- 種類:
str
- デフォルト:
./static
- 説明: faviconなどの静的ファイル用ディレクトリを指定します。
Ollama
ENABLE_OLLAMA_API
- 種類:
bool
- デフォルト:
True
- 説明: Ollama APIの使用を有効化します。
- 永続性: この環境変数は
PersistentConfig
変数です。
OLLAMA_BASE_URL
(OLLAMA_API_BASE_URL
は非推奨)
- 種類:
str
- デフォルト:
http://localhost:11434
- Dockerのデフォルト:
K8S_FLAG
が設定されている場合:http://ollama-service.open-webui.svc.cluster.local:11434
USE_OLLAMA_DOCKER=True
の場合:http://localhost:11434
- その他の場合:
http://host.docker.internal:11434
- 説明: OllamaバックエンドURLを構成します。
OLLAMA_BASE_URLS
- 種類:
str
- 説明: 負荷分散されたOllamaバックエンドホスト を
;
で区切って設定します。詳細はOLLAMA_BASE_URL
を参照。OLLAMA_BASE_URL
より優先されます。 - 例:
http://host-one:11434;http://host-two:11434
- 永続性: この環境変数は
PersistentConfig
変数です。
USE_OLLAMA_DOCKER
- 種類:
bool
- デフォルト:
False
- 説明: 同梱されたOllamaインスタンスでDockerイメージをビルドします。
K8S_FLAG
- 種類:
bool
- デフォルト:
False
- 説明: 設定されている場合、Helmチャートのデプロイメントを想定し、
OLLAMA_BASE_URL
をhttp://ollama-service.open-webui.svc.cluster.local:11434
に設定します。
OpenAI
ENABLE_OPENAI_API
- 種類:
bool
- デフォルト:
True
- 説明: OpenAI APIの使用を有効化します。
- 永続性: この環境変数は
PersistentConfig
変数です。
OPENAI_API_BASE_URL
- 種類:
str
- デフォルト:
https://api.openai.com/v1
- 説明: OpenAIの基本API URLを構成します。
- 永続性: この環境変数は
PersistentConfig
変数です。
OPENAI_API_BASE_URLS
- 種類:
str
- 説明: 負荷分散対応のOpenAI API URL(セミコロン区切り)をサポートします。
- 例:
http://host-one:11434;http://host-two:11434
- 永続性: この環境変数は
PersistentConfig
変数です。
OPENAI_API_KEY
- 種類:
str
- 説明: OpenAI APIキーを設定します。
- 例:
sk-124781258123
- 永続性: この環境変数は
PersistentConfig
変数です。
OPENAI_API_KEYS
- 型:
str
- 説明: 複数のOpenAI APIキーをセミコロンで区切ってサポートします。
- 例:
sk-124781258123;sk-4389759834759834
- 永続性: この環境変数は
PersistentConfig
変数です。
タスク
TASK_MODEL
- 型:
str
- 説明: Ollamaモデルを使用する場合のタイトル生成やウェブ検索クエリ生成などのタスクに使用するデフォルトモデル。
- 永続性: この環境変数は
PersistentConfig
変数です。
TASK_MODEL_EXTERNAL
- 型:
str
- 説明: OpenAI互換エンドポイントを使用する場合のタイトル生成やウェブ検索クエリ生成などのタスクに使用するデフォルトモデル。
- 永続性: この環境変数は
PersistentConfig
変数です。
TITLE_GENERATION_PROMPT_TEMPLATE
- 型:
str
- 説明: チャットタイトルを生成する際に使用するプロンプト。
- デフォルト:
DEFAULT_TITLE_GENERATION_PROMPT_TEMPLATE
環境変数の値。
DEFAULT_TITLE_GENERATION_PROMPT_TEMPLATE
:
### タスク:
チャット履歴を要約した簡潔なタイトルを、絵文字を含めて3~5語で生成してください。
### ガイドライン:
- タイトルは会話の主要なテーマまたは内容を明確に表現する必要があります。
- 特殊記号や引用符を使用せず、テーマの理解を深める絵文字を利用してください。
- チャットの主要言語でタイトルを作成し、複数言語の場合はデフォルトで英語にしてください。
- 過度な創造性よりも正確さを優先してください。シンプルで明快に保ちましょう。
### 出力:
JSON形式: { "title": "ここに簡潔なタイトル" }
### 例:
- { "title": "📉 株式市場のトレンド" },
- { "title": "🍪 チョコチップの完璧なレシピ" },
- { "title": "音楽ストリーミングの進化" },
- { "title": "リモートワーク生産性向上のコツ" },
- { "title": "医療における人工知能" },
- { "title": "🎮 ゲーム開発の洞察" }
### チャット履歴:
<chat_history>
{{MESSAGES:END:2}}
</chat_history>
- 永続性: この環境変数は
PersistentConfig
変数です。
TOOLS_FUNCTION_CALLING_PROMPT_TEMPLATE
- 型:
str
- 説明: ツールを呼び出す際に使用するプロンプト。
- デフォルト:
DEFAULT_TOOLS_FUNCTION_CALLING_PROMPT_TEMPLATE
環境変数の値。
DEFAULT_TOOLS_FUNCTION_CALLING_PROMPT_TEMPLATE
:
利用可能なツール: {{TOOLS}}
タスクはクエリに基づき、利用可能なツールのリストから正しいツールを選択して返却することです。以下のガイドラインに従ってください:
- JSONオブジェクトのみを返し、追加のテキストや説明は含めないでください。
- クエリに一致するツールがない場合、空の配列を返してください:
{
"tool_calls": []
}
- クエリに一致するツールが1つ以上ある場合は、以下を含むJSONレスポンスを作成してください:
- "name": ツールの名前。
- "parameters": 必要とされるパラメータおよびその対応する値の辞書。
JSONレスポンス形式は厳密に以下の通りです:
{
"tool_calls": [
{"name": "toolName1", "parameters": {"key1": "value1"}},
{"name": "toolName2", "parameters": {"key2": "value2"}}
]
}
- 永続性: この環境変数は
PersistentConfig
変数です。
コード実行
ENABLE_CODE_EXECUTION
- 型:
bool
- デフォルト:
True
- 説明: コード実行の有効化または無効化。
- 永続性: この環境変数は
PersistentConfig
変数です。
CODE_EXECUTION_ENGINE
- 型:
str
- デフォルト:
pyodide
- 説明: 使用するコード実行 エンジンを指定します。
- 永続性: この環境変数は
PersistentConfig
変数です。
CODE_EXECUTION_JUPYTER_URL
- 型:
str
- デフォルト:
None
- 説明: コード実行で使用するJupyter URLを指定します。
- 永続性: この環境変数は
PersistentConfig
変数です。
CODE_EXECUTION_JUPYTER_AUTH
- 型:
str
- デフォルト:
None
- 説明: コード実行で使用するJupyter認証方法を指定します。
- 永続性: この環境変数は
PersistentConfig
変数です。
CODE_EXECUTION_JUPYTER_AUTH_TOKEN
- 型:
str
- デフォルト:
None
- 説明: コード実行で使用するJupyter認証トークンを指定します。
- 永続性: この環境変数は
PersistentConfig
変数です。
CODE_EXECUTION_JUPYTER_AUTH_PASSWORD
- 型:
str
- デフォルト:
None
- 説明: コード実行で使用するJupyter認証パスワードを指定します。
- 永続性: この環境変数は
PersistentConfig
変数です。
CODE_EXECUTION_JUPYTER_TIMEOUT
- 型:
str
- デフォルト: 空文字(' '), デフォルトが
None
であるため。 - 説明: Jupyterコード実行のタイムアウトを指定します。
- 永続性: この環境変数は
PersistentConfig
変数です。
コードインタプリタ
ENABLE_CODE_INTERPRETER
- 型:
bool
- デフォルト:
True
- 説明: コードインタプリタの有効化または無効化。
- 永続性: この環境変数は
PersistentConfig
変数です。
CODE_INTERPRETER_ENGINE
- 種類:
str
- デフォルト:
pyodide
- 説明: 使用するコードインタプリタエンジンを指定します。
- 永続性: この環境変数は
PersistentConfig
変数です。
CODE_INTERPRETER_PROMPT_TEMPLATE
- 種類:
str
- デフォルト:
None
- 説明: コードインタプリタのプロンプトテンプレートを指定します。
- 永続性: この環境変数は
PersistentConfig
変数です。
CODE_INTERPRETER_JUPYTER_URL
- 種類:
str
- デフォルト: 空文字列 ()、デフォルトが
None
のため。 - 説明: コードインタプリタで使用するJupyterのURLを指定します。
- 永続性: この環境変数は
PersistentConfig
変数です。
CODE_INTERPRETER_JUPYTER_AUTH
- 種類:
str