> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/ja/insutru/using-the-toolkit/5.-personalizing-your-instance.md).

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

### インスタンスのパーソナライズ <a href="#personalizing-your-instance" id="personalizing-your-instance"></a>

Overleaf インスタンスを初めて起動する前に、 `config/variables.env` 設定ファイルをカスタム情報で更新してください。

{% stepper %}
{% step %}

### variables ファイルを編集する

開く `config/variables.env` をお好みのテキストエディタで開き、以下の環境変数を必要な値に更新してください。
{% endstep %}

{% step %}

### 必要な環境変数

次の変数を `config/variables.env`:

| 名前                            | 説明                                                                                  | 例                               |
| ----------------------------- | ----------------------------------------------------------------------------------- | ------------------------------- |
| `OVERLEAF_SITE_URL`           | Overleaf インスタンスが公開されている場所です。これは公開リンクや WebSocket 接続時に使用されるため、 **正しく設定されている必要があります**! | `https://overleaf.lilliput.com` |
| `OVERLEAF_EMAIL_FROM_ADDRESS` | このメールアドレスは、 `差出人` として、すべての送信メールに使用されます。                                             | `no-reply@lilliput.com`         |
| `OVERLEAF_ADMIN_EMAIL`        | ユーザーがサイト運営者に連絡できるメールアドレスです。                                                         | `it-services@lilliput.com`      |

これらの環境変数を更新したら、保存して終了してください。
{% endstep %}

{% step %}

### インスタンスを起動する

インスタンスを起動するには、次を実行します:

{% code title="インスタンスを起動する" %}

```
bin/up
```

{% endcode %}

このコマンドは必要なイメージをダウンロードし、（カスタマイズを使用して）コンテナを作成し、インスタンスを起動します。さまざまな Docker コンテナからログ出力が表示されるはずです。

後で再度起動するには（ログ出力を表示せずに）次を実行します:

{% code title="ログを表示せずに起動する" %}

```
bin/start
```

{% endcode %}
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Toolkit は `docker compose` Overleaf の Docker コンテナを管理するために使用します。Toolkit は、 `docker compose` をラップする一連のスクリプトを提供し、細かな作業のほとんどを代行します。
{% endhint %}

すべてが順調に進めば、 <http://127.0.0.1/> または <http://localhost/> にブラウザでアクセスすることで、新しい Overleaf インスタンスのログインページを表示できます。

{% hint style="warning" %}
ネットワーク構成や Overleaf インスタンスのホスティング先によっては、追加の設定変更が必要になる場合があります。詳細は Toolkit の設定を参照してください:

<https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/toolkit-settings>
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/on-premises/ja/insutru/using-the-toolkit/5.-personalizing-your-instance.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.