【備忘録】古いノートPC＋Ubuntu環境にOpenWebUIとOpenRouterを導入して無料LLM環境を構築する

家に眠っていた古いノートPCにUbuntuをインストールし、Dockerを用いてOpenWebUIを構築。頭脳としてOpenRouterの無料APIを接続するまでの手順と、発生したトラブルの解決策の備忘録。

1. 構成環境

ハードウェア: 古いノートPC（スペック不問、GPUなし、メモリ8GB等）
OS: Ubuntu Linux
UI環境: OpenWebUI (Dockerコンテナ)
APIインフラ: OpenRouter (DeepSeek-V3:Free, Qwen2.5-72B:Free 等を利用)

2. 構築手順

① DockerでOpenWebUIの起動

Dockerを用いてOpenWebUIコンテナをデプロイする。起動後は http://localhost:3000 にブラウザでアクセス。

② OpenRouterでAPIキーの取得

Nvidia NIM等で発生する組織制限（後述）を回避するため、OpenRouterを使用。

OpenRouter（ https://openrouter.ai/ ）でアカウント作成。
「Keys」メニューから新しいAPIキーを発行し、sk-or-v1- から始まる文字列をコピー。

③ OpenWebUI側の外部接続設定

OpenWebUIの設定画面からOpenRouterのAPIを登録する。

左下のユーザーアイコン＞ 「管理者設定 (Admin Settings)」 を選択。
左メニューの 「外部接続 (Connections)」 を選択。
OpenAI APIの項目に以下を入力して保存。
- API URL: https://openrouter.ai/api/v1
- API Key: OpenRouterで取得した sk-or-v1-... のキー
画面上部のモデル選択から deepseek/deepseek-chat:free 等を選択して利用開始。

3. トラブルシューティング（踏んだ罠と対策）

🛑 トラブル1：起動直後にステータスが `unhealthy` になる

事象: docker ps で確認時、OpenWebUIのステータスが unhealthy のままチャット画面が開かない。
原因: 古いPCスペックの場合、初期起動時の内部データベース作成や初期化処理に時間がかかっているだけだった。
対策: コマンドの再実行や再起動はせず、**「処理が完了するまで何もせず待つ」**ことで自然に healthy に移行した。

🛑 トラブル2：`watch` コマンドから元のターミナルに戻れない

事象: コンテナの状態を監視するために watch コマンドを実行したが、終了方法（exit 等）が分からずターミナルがロックされた。
原因: Linuxにおける標準的な画面監視コマンドの終了方法の誤認。
対策: Ctrl + C を入力してコマンドを強制終了する。

🛑 トラブル3：Nvidia NIMで「API Access Restricted by your Organization」エラー

事象: 当初Nvidia NIMのAPIを利用しようとしたが、「組織（Organization）による制限」が発生しAPIキーの発行がブロックされた。アカウントの再作成やGoogle連携の切り替えでも解消せず。
原因: 個人アドレスであってもシステム側に組織アカウント（学校・企業等）として誤認識されると、ビジネス向けのAPIアクセス権限制限に引っかかる仕様。
対策: Nvidiaの使用を諦め、個人利用に制限のない 「OpenRouter」へ接続先を変更することで即座に回避。

4. この構成（セミ・ローカル）のメリット

古いPCでOllama等を用いた「完全ローカルLLM」を動かそうとすると、マシンスペックがボトルネックになり実用的な速度が出ない。
今回の**「UIはローカル（Ubuntu上のOpenWebUI）、推論処理はクラウド（OpenRouterの無料枠）」**という構成にすることで、以下のメリットを得られた。

ローカルPCへの負荷がほぼゼロ: 推論処理がクラウド側で行われるため、ファンが回ることもなく低スペックPCでもサクサク動作する。
超大型モデルが利用可能: ローカルでは絶対に動かない DeepSeek-V3 や Qwen 2.5 (72B) などの最先端モデルが無料枠で利用できる。