Mac mini 上の Gemma 4 環境構築メモ
環境:Mac mini M2 / メモリ16GB / macOS macOS 26.4.1
目的:ブラウザのみでローカルLLMにアクセスできるエッジサーバーの構築
- 構成の概要
- STEP 1:LM Studio のインストール
- STEP 2:モデルのダウンロード(Gemma 4 E4B)
- STEP 3:LM Studio のローカル API サーバーを起動
- STEP 4:Docker Desktop のインストール
- STEP 5:Open WebUI コンテナの起動
- STEP 6:管理者アカウントの作成
- STEP 7:Open WebUI と LM Studio を接続
- STEP 8:動作確認(ローカル)
- STEP 9:LAN 内の他端末からアクセス
- 付録:Cloudflare Tunnel で外部公開
- ユーザー管理(Open WebUI)
- 関連情報
- 参照
構成の概要

- LM Studio:推論エンジン。Gemma 4 E4B を読み込み、OpenAI 互換 API サーバーとして公開する
- Open WebUI:チャットUI。Docker 上で動作し、LM Studio の API を呼び出す
- クライアント:ブラウザのみでアクセス可能。アプリインストール不要
STEP 1:LM Studio のインストール
- https://lmstudio.ai/ にアクセス
- Apple Silicon (M1/M2/M3) 用のインストーラ(
.dmg)をダウンロード .dmgを開き、LM Studio アイコンをApplicationsフォルダへドラッグ- 初回起動時は「インターネットからのダウンロード」警告が出るので「開く」を選択
STEP 2:モデルのダウンロード(Gemma 4 E4B)
- LM Studio を起動し、上部の検索バーに
gemma-4-E4B-it-GGUFと入力 - 検索結果から
gemma-4-E4B-it-GGUFをクリック - 「Download Options」から
Q4_K_MまたはQ5_K_Mと記載されているファイルを選択してダウンロード- ファイルサイズの目安:約6.3GB
Full GPU Offload Possible(緑表示)が出れば Mac M2 の 16GB で全量 GPU に載ることを意味する
量子化レベルについて
Q4_K_M:精度とメモリのバランスが良い(推奨)
Q5_K_M:やや高精度、メモリ消費もやや増
STEP 3:LM Studio のローカル API サーバーを起動
- 左端の縦メニューから 上から2番目のアイコン(「Developer」画面) をクリック
- 左側のメニューから 「Local Server」 を選択
- 画面上部「+ Load Model」ボタンから
gemma-4-E4B-it-GGUFを選択して読み込む - 「Server Settings」ボタン をクリックし、CORS を ON にする(ブラウザからの接続に必須)
- 画面上部の
Status: Runningトグルスイッチをオンにする(緑色になれば起動完了) - 「Loaded Models」に
gemma-4-e4b-itが READY と表示されることを確認 - Developer Logs に
Server listening on http://127.0.0.1:1234と出ていれば成功
補足:右側パネルの「Model Information」で以下を確認できる
- Format: GGUF / Quantization: Q4_K_M
- Capabilities: Vision(画像認識)・Tool use(ツール利用)対応
- Parallel: 4(同時4リクエストまで処理可能)
STEP 4:Docker Desktop のインストール
Homebrew でインストールする:
brew install --cask docker
インストール後の初期設定:
- アプリケーションフォルダから
Dockerを起動(またはopen /Applications/Docker.app) - 利用規約(Docker Subscription Service Agreement)に「Accept」
- システム権限付与のため管理者パスワードを入力
- メニューバーの Docker アイコンが止まり「Docker Desktop is running」になれば完了
STEP 5:Open WebUI コンテナの起動
ターミナルで以下のコマンドを実行:
docker run -d -p 3000:8080 \ --add-host=host.docker.internal:host-gateway \ -v open-webui:/app/backend/data \ --name open-webui \ --restart always \ ghcr.io/open-webui/open-webui:main
確認方法:
- Docker Desktop の
Containersタブでopen-webuiが緑色のRunning状態になっていれば成功 - Mac mini のブラウザで
http://localhost:3000にアクセスしてログイン画面が表示されれば起動完了
STEP 6:管理者アカウントの作成
http://localhost:3000にアクセス- 「サインアップ(Sign Up)」から名前・メールアドレス・パスワードを登録
- 最初に作成したアカウントが自動的に管理者権限を持つ
STEP 7:Open WebUI と LM Studio を接続
- Open WebUI にログイン後、左下のアカウントアイコン →「管理者パネル」を開く
- 「設定(Settings)」→「接続(Connections)」タブを選択
- OpenAI API のセクションの歯車アイコンをクリック
- URLを以下に変更(
localhostではなくhost.docker.internalと入力するのが重要):http://host.docker.internal:1234/v1 - APIキー欄に
lm-studioと入力(ローカルなので何でもよいが空欄はエラーになる) - ダイアログ内の「保存」をクリック → 画面右下の大きな「保存」ボタンも押す
- チャット画面に戻り、モデル選択プルダウンに
gemma-4-e4b-itが表示されれば接続成功
STEP 8:動作確認(ローカル)
チャット画面でモデルを選択してメッセージを送り、応答が返れば環境構築完了。
STEP 9:LAN 内の他端末からアクセス
同じネットワーク(同じルーター)に接続されている端末のブラウザから:
http://< Macのローカル IP アドレス>:3000
例:http://192.168.1.2:3000
Mac のローカル IP アドレスの確認方法:
「システム設定」→「ネットワーク」→ 接続中のWi-FiのIPアドレスを確認
学校ネットワークの注意点
プライバシーセパレーター(端末間通信遮断)や VLAN が設定されている場合、同一 Wi-Fi でも接続できないことがある。ネットワーク管理者への確認が必要。
付録:Cloudflare Tunnel で外部公開
負荷テストや外部の知り合いに試用させる場合に使う一時的な手段。
# インストール(未インストールの場合) brew install cloudflared # トンネルの起動 cloudflared tunnel --url http://localhost:3000
起動後、ログに表示される以下の形式の URL を共有する:
https://xxxxxxxx-xxxxxxxx.trycloudflare.com
終了するには Ctrl + C を押す。URL はその時点で無効化される。
ユーザー管理(Open WebUI)
- 新規サインアップ時に入力するメールアドレスはダミーで可
- 新規サインアップしたユーザーは初期状態で「保留中(Pending)」になる
- 「管理者パネル」→「ユーザー」タブで対象ユーザーのロールを
userに変更する - モデルが「プライベート」に設定されている場合、一般ユーザーには表示されない
→ 「ワークスペース」→「モデル」→ 対象モデルのアクセス権を「公開(すべてのユーザーにアクセス可能)」に変更する
関連情報
- Gemma 4 E4B:「Effective 4B」の略。約40億の有効パラメータ。PLE 技術により効率的な推論を実現。エッジデバイス向け。
- LM Link:LM Studio の有料機能。異なるネットワーク間での端末接続(Tailscale ベース)。教室内 LAN 利用であれば不要。
- GGUF形式:LM Studio が対応するモデルファイル形式。Hugging Face からダウンロード可能。
- host.docker.internal:Dockerコンテナ内からホスト OS (Mac本体)のサービスにアクセスするための特殊なホスト名。
localhostでは届かない。
参照
- LM Studio 公式:https://lmstudio.ai/
- Gemma 4 モデル一覧:https://lmstudio.ai/models/gemma-4
- LM Link:https://lmstudio.ai/link
- Open WebUI 公式:https://openwebui.com/