> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 0. Docker のセットアップ

> Overleaf をデプロイするために、Ubuntu に Docker Engine と Compose プラグインをインストールします。

Overleaf は Docker 上で動作します。以下をインストールする必要があります。

* Docker Engine(Docker CE)
* Docker Compose プラグイン(`docker compose`、v2)

この手順は最近の Ubuntu LTS(20.04/22.04/24.04)を対象としています。

> [!WARNING]
>
> Ubuntu のデフォルトの apt リポジトリから `docker.io` をインストールしないでください。\
> 最新の Docker バージョンと `docker compose` プラグインを入手するために、Docker の公式リポジトリを使用してください。

公式ドキュメントはこちらです: [https://docs.docker.com/engine/install/ubuntu/](https://docs.docker.com/engine/install/ubuntu/)

**1. 1) 古いパッケージや競合するパッケージを削除する(存在する場合)**

以前に別のソースから Docker をインストールしていた場合は、まずそれを削除します。

```bash wrap theme={null}
sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc | cut -f1)
```

一部のパッケージがインストールされていなくても、このコマンドは安全に実行できます。

**2. 2) Docker の公式 apt リポジトリを追加する**

前提パッケージをインストールします。

```bash theme={null}
sudo apt update
sudo apt install -y ca-certificates curl
```

Docker の GPG キーを追加します。

```bash wrap theme={null}
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
```

リポジトリを追加します。

```bash wrap theme={null}
# Add the repository to Apt sources:
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update
```

**3. 3) Docker Engine と Compose プラグインをインストールする**

Docker と Compose プラグインをインストールします。

```bash wrap theme={null}
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```

起動時に Docker を開始するように設定します。

```bash theme={null}
sudo systemctl enable --now docker
```

**4. 4) インストールを確認する**

以下のコマンドがエラーなく実行できるはずです。

```bash theme={null}
docker --version
docker compose version
sudo docker run --rm hello-world
docker ps
```

**5. 5) (任意) sudo なしで Docker を実行する**

ユーザーを `docker` グループに追加します。

```bash theme={null}
sudo usermod -aG docker $USER
```

その後、**ログアウトして再度ログイン**するか、次を実行します。

```bash theme={null}
newgrp docker
```

これで `sudo` なしで次のコマンドが動作するはずです。

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

> [!CAUTION]
>
> `docker` グループはホスト上で root 相当のアクセス権を持ちます。\
> これは一般的な Overleaf のインストールでは想定どおりであり、Sandboxed Compiles を有効にする場合は特に関係します。

### 次のステップ

Docker が動作するようになったら、[1. Toolkit をダウンロードする](https://ayakaleaf-pro.mintlify.site/ja/on-premises/installation/using-the-toolkit/1.-download-the-toolkit.md)に進んでください。


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