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

​

インスタンスのカスタマイズ

Overleaf インスタンスを初めて起動する前に、config/variables.env 設定ファイルを独自の情報で更新します。

1. 変数ファイルを編集する

   お好みのテキストエディターで config/variables.env を開き、以下の環境変数を必要な値に更新します。

2. 必須の環境変数

   config/variables.env の次の変数を更新します。

   名前	説明	例
   OVERLEAF_SITE_URL	Overleaf インスタンスが公開されている場所。公開リンクや WebSocket 接続で使用されるため、正しく設定する必要があります！	https://overleaf.lilliput.com
   OVERLEAF_EMAIL_FROM_ADDRESS	このメールアドレスは、すべての送信メールの from アドレスとして使用されます。	[e-mail]
   OVERLEAF_ADMIN_EMAIL	ユーザーがサイトの運営者に連絡するためのメールアドレス。	[e-mail]

   これらの環境変数を更新したら、保存して終了します。

3. Sandbox Compile をセットアップする

   次に、sandboxed-compiles.md 用に TeX Live Full を設定します。config/variables.env を開き、次の環境変数を更新します。

   config/variables.env

   ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1
   ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025
   TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
   
4. インスタンスを起動する

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

   Start the instance

   bin/up
   

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

   後で（ログ出力にアタッチせずに）再度起動するには、次を実行します。

   Start without attaching to logs

   bin/start
   

Toolkit は docker compose を使用して Overleaf の Docker コンテナを管理します。Toolkit には docker compose をラップする一連のスクリプトが用意されており、細かい作業のほとんどを代わりに処理してくれます。

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

ネットワーク構成や Overleaf インスタンスのホスト場所によっては、追加の設定変更が必要になる場合があります。詳しくは Toolkit の設定を参照してください：toolkit-settings.md