> ## 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.

# 5. インスタンスのカスタマイズ

> ポート、サイト URL、TeX Live イメージを設定し、サンドボックスコンパイルを有効にして、WSL 2 上で Ayakaleaf Pro を起動します。

コマンドの実行とファイルの編集は、**Ubuntu** で `~/ayakaleaf-toolkit` から行います。

**1. コンテナの設定**

`config/overleaf.rc` の既存エントリを編集します:

```bash title="config/overleaf.rc" theme={null}
PROJECT_NAME=ayakaleaf-wsl
SERVER_PRO=true
OVERLEAF_LISTEN_IP=127.0.0.1
OVERLEAF_PORT=8080
SIBLING_CONTAINERS_ENABLED=true
DOCKER_SOCKET_PATH=/var/run/docker.sock
```

デフォルトのデータパスと、同梱の MongoDB および Redis サービスはそのままにしてください。ポート `8080` はローカルの Windows ブラウザー用で、`127.0.0.1` にバインドすることでローカルからのアクセスに限定されます。サンドボックスコンパイルでは、アプリケーションコンテナ内で TeX を実行するのではなく、コンパイルごとに個別の Linux コンテナを使用します。Docker ソケットによりアプリケーションがそれらのコンテナを作成でき、Toolkit は `data/overleaf/data/compiles` 以下のコンパイルデータ用のホストパスを提供します。

**2. アプリケーションの設定**

`config/variables.env` で次の値を設定し、同じ名前の有効なエントリがあれば置き換えます:

```dotenv title="config/variables.env" theme={null}
OVERLEAF_SITE_URL=http://localhost:8080
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES="TeX Live 2026"
```

フルイメージには、幅広いプロジェクトに必要なパッケージとフォントが含まれています。このイメージとアプリケーション用に少なくとも 40 GB の空きストレージを確保し、さらにプロジェクトデータと今後のアップデート用の容量も確保してください。

デプロイを手早くテストするには、代わりに小さい **basic** イメージを使用してください。ステップ 6 のシンプルな article のテストには十分ですが、パッケージとフォントの完全なセットは含まれていません:

```dotenv theme={null}
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-basic:2026.1
ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-basic:2026.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES="TeX Live 2026 Basic"
```

これらのセットのいずれか 1 つを選び、有効なキーが重複しないようにしてください。basic イメージの [Dockerfile](https://github.com/ayaka-notes/texlive-full/blob/main/texlive/2026/Dockerfile.basic) には `latexmk`、XeTeX、`fontspec` が含まれていますが、`ctex` やフォントの完全なコレクションは含まれていません。basic で LaTeX パッケージが見つからないことは、それだけではサンドボックスの問題を示すものではありません。

セッションシークレットを生成します:

```bash theme={null}
openssl rand -hex 32
```

結果を `config/variables.env` に `OVERLEAF_SESSION_SECRET` として追加します。生成された招待トークンのシークレットも保持してください。メールを使用しないローカルインスタンスでは、SMTP の設定と `OVERLEAF_EMAIL_FROM_ADDRESS` は未設定のままにしてください。

**3. インスタンスを起動する**

```bash theme={null}
bin/up -d
```

Toolkit は MongoDB を起動してそのレプリカセットを初期化し、選択した TeX Live イメージをダウンロードしてから、Redis とアプリケーションを起動します。大きなイメージのダウンロード中は、処理が止まっているように見えることがあります。最初の `bin/up` が処理中の間は、2 回目の `bin/up` を実行しないでください。

別の Ubuntu ターミナルで次を確認します:

```bash theme={null}
cd "$HOME/ayakaleaf-toolkit"
bin/docker-compose ps
bin/docker-compose logs --tail=100 mongo
bin/docker-compose logs --tail=100 -f sharelatex
```

`Ctrl+C` を押すとログの追跡を停止します。デタッチされたコンテナは引き続き実行されます。MongoDB で起動に失敗した場合は、再試行する前に [MongoDB が起動しない](https://ayakaleaf-pro.mintlify.site/ja/on-premises/installation/using-docker-compose/windows/troubleshooting.md#mongodb-fails-to-start)に従ってください。既存のインストールをリセットするためにデータディレクトリを削除しないでください。

ポートと初回起動ページを確認します:

```bash theme={null}
bin/docker-compose port sharelatex 80
curl -I http://localhost:8080/launchpad
```

ポートは `127.0.0.1:8080` になっているはずです。HTTP リクエストが最初に失敗する場合は、アプリケーションの初期化が終わるまで待ってください。

**4. Windows からインスタンスを開く**

**Windows のブラウザー**で [http://localhost:8080/launchpad](http://localhost:8080/launchpad) を開きます。Windows でも、一時的な WSL の IP アドレスではなく、このアドレスを使用してください。

ブラウザーとは別に Windows からの HTTP アクセスを確認するには、**PowerShell** で次を実行します:

```powershell theme={null}
curl.exe -I http://localhost:8080/launchpad
```

Ubuntu からはページにアクセスできるのに Windows からはアクセスできない場合は、[Windows から localhost を開けない](https://ayakaleaf-pro.mintlify.site/ja/on-premises/installation/using-docker-compose/windows/troubleshooting.md#windows-cannot-open-localhost)を参照してください。

### 次のステップ

[6. インストール後のタスク](https://ayakaleaf-pro.mintlify.site/ja/on-premises/installation/using-docker-compose/windows/6.-post-installation-tasks.md)に進み、管理者を作成して、サンドボックスコンパイルと永続化を確認してください。


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