🐧🦙🐋 あなたのPCでWSL2とDockerを使ってllama3を実行する

ローカル環境で Ollama を実行するには、**Windows Subsystem for Linux (WSL)** 内で **Docker** を使うのが最も簡単で効果的な方法です。
このチュートリアルでは、その手順を順を追ってご紹介します。

---

## 🐧 Windows に WSL と Docker をインストールする

このガイドでは、Windows 上で **WSL (Windows Subsystem for Linux)** と **Docker** をインストールする方法をご説明します。

---

# 1. WSL を有効にする

**PowerShell（管理者権限）** を開き、以下のコマンドを実行してください：

```powershell
wsl --install
```

このコマンドにより、デフォルトで Ubuntu がインストールされます。WSL2 が有効になっていない場合も、自動的に有効化されます。

![Powershell WSL install](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/lylw2etnvgx75t8q09lo.png)

### パソコンを再起動してください

Ubuntu のインストールが完了したら、**PC を再起動**してください。

---

## Linux ディストリビューションを設定する

再起動後、WSL（Ubuntu）が起動し、ユーザー名とパスワードの設定を求められます。

自動で起動しない場合は、以下のコマンドで起動できます：

```powershell
wsl
```

または、スタートメニューから **Ubuntu** を起動してください。

---

## Ubuntu をアップデートする

WSL ターミナル内で以下のコマンドを実行します：

```bash
sudo apt update && sudo apt upgrade -y
```

---

# 2. 🐳 WSL (Ubuntu) に Docker をインストールする

以下は [Docker 公式 Ubuntu インストールガイド](https://docs.docker.com/engine/install/ubuntu/) に基づいています。

### Apt にリポジトリを追加する：

```bash
# Docker の公式 GPG キーを追加：
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# リポジトリを Apt ソースに追加：
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
```

### Docker をインストールする：

```bash
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```

---

## `sudo` なしで Docker を実行する（任意）

```bash
sudo usermod -aG docker $USER
```

その後、**WSL またはターミナルを再起動**します：

```bash
exit
```

再度開いて、以下のコマンドで確認できます：

```bash
docker run hello-world
```

以下のような画面が表示されます：

![Docker Hello-world Image](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/ikf7fhd8x757p5qxi365.png)

---

# 3. 🦙 WSL Ubuntu 環境に Ollama をインストールする

**Ollama** を **Docker** を使ってインストール・実行します。詳細は公式の [Ollama Docker ページ](https://hub.docker.com/r/ollama/ollama) を参照してください。

私の環境（ノートパソコン）では GPU がないため、**CPU バージョン**を使用しました。
GPU をお持ちの方は、**GPU バージョンの使用を強くおすすめ**します（パフォーマンスが大幅に向上します）。

---

### 1. **Docker コンテナを実行する：**

```bash
docker run -d -v ollama:/root/.ollama -p 11434:11434 --name ollama ollama/ollama
```

---

### 2. **モデルを実行する（例：llama3）：**

```bash
docker exec -it ollama ollama run llama3
```

`llama3` モデルがダウンロードされ、実行されます。
これで Ollama と対話できるようになります。

以下のコマンドでヘルプやオプションを確認できます：

```bash
/? 
```

![Ollama running in WSL](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/rv0s1pbone1mlrbimlcu.png)

---

### 3. **次回以降の起動方法：**

WSL を再度起動した際は、以下でコンテナを再起動します：

```bash
docker start ollama
```

その後、再びモデルを実行：

```bash
docker exec -it ollama ollama run llama3
```

![Running llama3](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/rpg8znpc1sjwe28p7niq.png)

---

### 4. **ブラウザまたはクライアントからアクセス：**

以下にアクセスすると、Ollama が正常に動作していることを確認できます：

```
http://localhost:11434
```

次のようなレスポンスが返ります：

```json
{"message":"Ollama is running"}
```

![Localhost Ollama Message](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/si4vvqitawqqtuy48sog.png)

---

### 5. **Ollama を停止するには：**

```bash
docker stop ollama
```

---