> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mixroute.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenWebUI

> Docker ComposeでOpenWebUIをデプロイし、MixRouteに接続して、幅広い人気AIモデルを利用します。

Open WebUIは、複数のモデルプロバイダーに対応し、ユーザー管理とチャット履歴の永続化を備えた、多機能なオープンソースのAIインターフェースです。このガイドでは、Docker ComposeでOpen WebUIをデプロイし、**MixRoute**に接続して、幅広い人気のAIモデルにアクセスする手順を説明します。

* 公式ドキュメント: [docs.openwebui.com/getting-started/quick-start](https://docs.openwebui.com/getting-started/quick-start/)
* デプロイ方法：Docker Compose

## 前提条件

<Steps>
  <Step title="MixRouteの認証情報を準備">
    <Tip>
      現在のサイトはモデルの[スマートルーティング](/ja/api-reference/smart-routing)に対応しており、タスクの複雑さに応じて最適なモデルを自動的に割り当てます。詳細は以下を参照してください。
    </Tip>

    1. MixRouteのAPIエンドポイントURLを取得します: `https://api.mixroute.ai/v1`
    2. MixRouteコンソールでAPIキーを生成します。
    3. 使用するモデル名（例: `gpt-5.5`）を確認します（そのモデルがMixRouteコンソールで有効になっていることを確認してください）。
  </Step>

  <Step title="環境の依存関係の確認">
    マシンまたはサーバーに**Docker**（Docker Compose V2を含む）がインストールされていることを確認してください。ターミナルで次を実行します。

    ```bash theme={null}
    docker -v
    docker compose version
    ```

    両方のコマンドでバージョン番号が返されれば、環境の準備は完了です。Dockerがインストールされていない場合は、[Dockerのウェブサイト](https://docs.docker.com/get-docker/)からDocker Desktop（Windows/macOS）またはDocker Engine（Linux）をダウンロードしてインストールし、上記のコマンドを再実行して確認してください。
  </Step>
</Steps>

## OpenWebUIをデプロイする

### 1. 専用フォルダーを作成

ターミナルを開き、次のコマンドを実行して`openwebui`フォルダーを作成し、その中に移動します。

```bash theme={null}
mkdir openwebui
cd openwebui
```

### 2. docker-compose.ymlを作成

`openwebui`フォルダー内に`docker-compose.yml`という名前のファイルを作成し、以下の内容を記述します（ファイル全体をコピーして貼り付けてください）。

```yaml theme={null}
services:
  openwebui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    restart: always
    ports:
      # host port:container port
      - "3000:8080"
    volumes:
      - open-webui:/app/backend/data

volumes:
  open-webui:
```

**フィールドリファレンス:**

| フィールド | 目的 |
| - | - |
| `image` | Open WebUIの公式イメージ（`main`は標準の安定版タグです） |
| `ports: "3000:8080"` | コンテナのポート8080をホストのポート3000にマッピングするため、UIにはポート3000でアクセスします |
| `volumes` | コンテナを再起動または更新しても、チャット履歴、アカウント、その他のデータを保持するための永続データディレクトリ |
| `restart: always` | コンテナが終了した場合、またはシステムが再起動した場合に、コンテナを自動的に再起動 |

<Note>
  Open WebUIをサーバー上またはLAN内で実行する場合は、`WEBUI_SECRET_KEY`と`WEBUI_URL`の環境変数を追加できます。

  * `WEBUI_SECRET_KEY`: `openssl rand -hex 32`で生成します。
  * `WEBUI_URL`：ご自身の公開IPアドレスまたはドメイン。

  マシン上でポート3000がすでに使用されている場合は、`"3000:8080"`を、たとえば`"3010:8080"`に変更し、`http://localhost:3010`でUIにアクセスしてください。
</Note>

### 3. サービスの起動

`docker-compose.yml`があるディレクトリで、次を実行します。

```bash theme={null}
docker compose up -d
```

* `up`: サービスを起動します
* `-d`: バックグラウンドで実行します

初回実行時はイメージが自動的に取得されます。ネットワーク環境によっては数分かかる場合があります。`Container open-webui Started`のようなメッセージが表示されたら、サービスは正常に起動しています。

実行状態を確認します。

```bash theme={null}
docker compose ps
```

`STATUS`列に`Up`が表示されていれば、サービスは正常に稼働しています。

## アクセスしてアカウントを初期設定

<Steps>
  <Step title="Web UIを開く">
    ブラウザーを開き、`http://localhost:3000`にアクセスしてください。

    リモートサーバーにデプロイした場合は、`localhost`をサーバーのIP（例：`http://SERVER_IP:3000`）に置き換えてください。
  </Step>

  <Step title="最初のアカウントを登録する">
    初回起動時に登録ページが表示されます。フォームに入力して登録してください。

    <Warning>
      最初に登録したアカウントは、自動的にユーザー管理とシステム設定の権限を持つ**管理者**アカウントになります。このアカウントのメールアドレスとパスワードを忘れないようにしてください。
    </Warning>
  </Step>

  <Step title="後から登録したユーザーの承認">
    その後に登録されたアカウントは、デフォルトで「承認待ち」の状態になります。UIを利用するには、管理者が管理パネルにログインして手動で承認する必要があります。
  </Step>
</Steps>

## MixRouteへの接続

Open WebUI自体はインターフェースにすぎません。チャットを始めるには、少なくとも1つのモデルプロバイダーに接続する必要があります。Open WebUIは、複数のモデルソースに対応しています。

| モデルソース | 説明 |
| - | - |
| Ollama（ローカルモデル） | オープンソースモデルをローカルで無料実行。ネットワーク呼び出しは不要 |
| OpenAI | OpenAI APIキーを使用してGPTファミリーのモデルにアクセス |
| Anthropic | Anthropic APIキーを使用してClaudeファミリーのモデルにアクセスします |
| その他のOpenAI互換サービス | 中継プラットフォームやセルフホスト型の推論サービスなど |

**MixRoute**経由の接続をお勧めします。1回の設定で200以上の人気AIモデルにアクセスでき、使いやすさを保ちながら適切なプライバシー保護を受けられます。

<Steps>
  <Step title="設定を開く">
    Open WebUIにログインしたら、左下のアバター → **設定**をクリックします。

    <img src="https://mintcdn.com/personal-a5418d9f/qwAKZlzOFRKXXp1S/images/openwebui-p1.png?fit=max&auto=format&n=qwAKZlzOFRKXXp1S&q=85&s=8662d96843f01722dba99e6d51147235" alt="OpenWebUI P1" width="541" height="937" data-path="images/openwebui-p1.png" />
  </Step>

  <Step title="接続パネルを開く">
    **管理者設定** → **接続**に移動してください。

    <img src="https://mintcdn.com/personal-a5418d9f/qwAKZlzOFRKXXp1S/images/openwebui-p2.png?fit=max&auto=format&n=qwAKZlzOFRKXXp1S&q=85&s=39c472a163ec27c4c3bb039ee5f7c678" alt="Open WebUI P2" width="2962" height="765" data-path="images/openwebui-p2.png" />
  </Step>

  <Step title="MixRouteの認証情報を入力">
    <Tabs>
      <Tab title="スマートルーティングノード">
        スマートルーティングノードの認証情報を入力します。**ベースURL**と**スマートルーティングAPIキー**を入力して保存してください。

        * **ベースURL**: `https://api.mixroute.ai/v1`
        * **APIキー**：スマートルーティングのAPIキー（例：`sk-xxxxxxxx`）
        * **モデルID**: **auto**を選択してください

        <Info>
          制約と認証情報の取得方法については、[スマートルーティング](/ja/api-reference/smart-routing)のドキュメントを参照してください。
        </Info>
      </Tab>

      <Tab title="従来のAPIノード">
        接続するプロバイダーの**Base URL**と**APIキー**を入力し、保存します。

        * **ベースURL**: `https://api.mixroute.ai/v1`
        * **APIキー**: ご自身のMixRoute APIキー（例: `sk-xxxxxxxx`）
        * **モデルID**: `gpt-5.5`などの具体的なモデルIDを入力するか、自動検出に任せてください。
      </Tab>
    </Tabs>

    <img src="https://mintcdn.com/personal-a5418d9f/qwAKZlzOFRKXXp1S/images/openwebui-p3.png?fit=max&auto=format&n=qwAKZlzOFRKXXp1S&q=85&s=f474eeace78f0a309e6e1017080643f3" alt="Openwebui P3" width="1081" height="1243" data-path="images/openwebui-p3.png" />
  </Step>

  <Step title="モデルを選択してチャットを開始する">
    メイン画面に戻ると、新しく接続したモデルがモデル選択欄に表示されます。選択するとチャットを開始できます。

    <Tip>
      当社のテストでは、GPTファミリーはOpenWebUIで良好な性能を示しました。GPTモデルと組み合わせることを推奨します。
    </Tip>
  </Step>
</Steps>

## 一般的なメンテナンス

### サービスの停止

```bash theme={null}
docker compose stop
```

### サービスを再起動

```bash theme={null}
docker compose start
```

### ログを確認（トラブルシューティング用）

```bash theme={null}
docker compose logs -f
```

### 最新バージョンに更新する

```bash theme={null}
docker compose pull
docker compose up -d
```

<Note>
  `pull`で最新のイメージを取得し、`up -d`で新しいイメージを使ってコンテナを再作成します。データはコンテナ本体とは別の`volumes`に保存されるため、安全に保持されます。
</Note>

### 完全アンインストール

コンテナのみを停止して削除します（データは保持されるため、`up -d`でいつでも復旧できます）。

```bash theme={null}
docker compose down
```

コンテナを停止して削除し、**すべてのデータも削除**します（チャット履歴やアカウントなどは完全に失われます。慎重に実行してください）。

```bash theme={null}
docker compose down -v
```

## FAQ

<Accordion title="ブラウザーでhttp://localhost:3000を開けない場合は？">
  * `docker compose ps`でコンテナが動作していることを確認し、`STATUS`が`Up`になっていることを確認してください。
  * ポートが別のプログラムによって使用されていないことを確認してください。使用されている場合は、`docker-compose.yml`のポートを変更し、`docker compose up -d`を再実行します。
</Accordion>

<Accordion title="管理者パスワードを忘れた場合">
  設定からパスワードをリセットできます。まったくログインできない場合は、データベースレベルでの対応が必要です。まずDiscord/GitHubコミュニティで支援を求め、データボリュームを直接削除しないことをおすすめします（削除するとすべてのデータが失われます）。
</Accordion>

<Accordion title="docker-compose.ymlの変更を反映するには？">
  ファイルを保存した後、同じディレクトリで次を実行します。

  ```bash theme={null}
  docker compose up -d
  ```

  Docker Composeは変更を自動的に検出し、コンテナを再作成します。
</Accordion>

<Info>
  設定が完了すると、Open WebUIのすべての会話と機能は、設定画面で紐付けたMixRouteエンドポイントによって動作し、堅牢で費用対効果の高いクラウドLLMサービスを利用できます。
</Info>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.