メインコンテンツへスキップ
ここでは、Ayakaleaf Pro に関するよくある質問への回答をまとめています。

基本的な質問

いいえ。Ayakaleaf Pro は完全に無料で使用できます。トライアル版ではなく、ライセンスも不要です。
はい。Ayakaleaf Pro には、Git-Bridge 連携を含む Overleaf Server Pro のすべての機能が含まれています。また、Overleaf SaaS プラットフォームの一部の機能も含まれています。私たちは引き続き Ayakaleaf Pro の開発と改善を進めています。
Overleaf Server Pro の費用は、1 ユーザーあたり年間約 $300 です。最低 10 ライセンスが必要なため、導入費用は年間およそ $3,000 からとなります。米国の小規模な公的契約では、1 ユーザーあたり年間約 $320〜$370 の費用が示されています。このため、Server Pro は特に小規模なチームにとって高価です。記録されている購入事例と価格については、#information-and-price-about-overleaf-server-pro を参照してください。
Overleaf Server Pro は政府機関でよく使用されています。これらの組織はプライベートネットワーク上に導入し、アクセスを厳格に管理しています。機密データを保護するため、搭載されている機能はサードパーティのサービスとのデータのやり取りを避けています。GitHub 同期、AI、または同様の接続型機能が必要な場合、Overleaf は SaaS プラットフォームのサブスクリプションを推奨しています。
Ayakaleaf Pro はオープンソースです。セキュリティと信頼性を強化するため、Codex Security などのツールを使ってコードをレビューしています。サードパーティとのデータ同期を有効にしない限り、データはあなたのサーバー上に留まります。Ayakaleaf Pro には、データを外部に送信するテレメトリは一切含まれていません。
このプロジェクトを長期的にメンテナンスできるよう、あらゆる努力を続けていきます。
Ayakaleaf Pro はコミュニティによるフォークです。コードと統合された機能はコミュニティの貢献によるものです。AGPL v3 の下でライセンスされています。導入環境は、このライセンスの要件を満たすことでライセンスに準拠できます。
このプロジェクトは 2024 年に当初 Overleaf Pro という名前でした。開発は一時中断した後、2025 年末に再開されました。2026 年の第 1 四半期に、Overleaf は AI 機能を備えたサブスクリプションプランの名称を Pro に変更しました。また、コミュニティからのフィードバックでも、Overleaf Pro という名前は商標やなりすましのリスクを生む可能性があると指摘されました。ユーザーにこのプロジェクトが公式のものであると誤解させる恐れがあります。こうした混乱を避けるため、プロジェクト名を Ayakaleaf Pro に変更しました。この名前は「Ayaka-notes Overleaf Pro」と読むことができます。メンテナー(ayaka と呼んでください!)は学生時代から 5 年以上にわたって Overleaf コミュニティの開発に貢献してきました。この経験が、私たちの長期的なメンテナンスへの取り組みを支えています。
2026 年以降、オープンソースコミュニティでは OpenAI Prism をはじめ、AI で構築された LaTeX エディターが数多くリリースされています。Ayakaleaf Pro は、データとサービスをあなた自身のサーバー上に保持します。これにより、導入環境とデータを直接管理できます。コミュニティの実験的なエディターの多くには、確立された長期的なメンテナンス計画がありません。サードパーティの LaTeX コンパイルプラットフォームも、ユーザー基盤や収益が不十分な場合には運営を停止する可能性があります。Ayakaleaf Pro はすべてのソースコードを提供し、すべてのサービスをセルフホストできます。たとえメンテナンスが停止したとしても、既存のセルフホスト環境は引き続き稼働できます。
プロジェクト名の変更(Q08 を参照)に伴い、ayaka-notes/ayakaleaf-pro に名前が変更されました。アーカイブされたり置き換えられたりしたわけではなく、同じリポジトリです。GitHub は古い ayaka-notes/overleaf-pro へのリンクや Git リモートを新しい名前にリダイレクトします。Docker イメージの名前は ghcr.io/ayaka-notes/overleaf-pro のままなので、config/overleaf.rc や config/version を変更する必要はありません。

機能

現在の機能一覧については、ドキュメントをご確認ください。追加してほしい機能がある場合は、GitHub で(機能リクエストとして)issue を気軽に作成してください。リクエストされた機能はできる限り実装するよう努めますが、開発には時間がかかるため、すべての機能をすぐに提供できるとは限りません。
コントリビューションは歓迎しますが、採用は保証されません。各 PR は、基盤となる Overleaf のコードベースへの影響、メンテナンスの負担、ユーザーにもたらす価値に基づいて評価します。価値のあるコントリビューションは、できる限りマージしてメンテナンスしていきます。ただし、過度な変更を加える PR、レビューされていない、または十分に理解されていない AI 生成コード(「バイブコーディング」)で構成された PR、長期的なメンテナンスが難しい機能を追加する PR は、却下する場合があります。
通常、新しい機能をリリースするたびにドキュメントを更新しています。詳しいセットアップ手順や利用可能な環境変数の説明については、該当するドキュメントを参照してください。
Python Runner は、サーバー上ではなく、ユーザーのブラウザ内で Pyodide 0.29.3 を使って Python を実行します。コードがインポートするパッケージは、NumPy、pandas、Matplotlib など、Pyodide に組み込まれたパッケージから読み込まれます。pip でインストールしたパッケージやその他のパッケージは利用できません。サーバー側で設定する項目はありません。
いいえ。スペルチェッカーには日本語や中国語の辞書がないため、これらの言語はスペルチェックの言語リストに含まれていません。ユーザーはエディターの設定で、プロジェクトのスペルチェックをオフにできます。単語がスペルミスとしてマークされないようにするには、その単語を右クリックして Add to dictionary を選択します。追加した単語はアカウントに保存され、すべてのプロジェクトに適用されます。確認または削除するには、エディターの設定を開き、Spelling and language → Dictionary → Edit を選択します。単語を追加しても、新しいスペルチェック言語が追加されるわけではありません。
プラグインのインストーラーはありません。機能はソースコードの services/web/modules にあるモジュールとして実装されており、Docker イメージに組み込まれ、このドキュメントに記載されている設定で有効になります。独自の機能を追加するには、ソースコードにモジュールを追加して独自のイメージをビルドしてください。

デプロイ

ほとんどのユーザーには、Toolkit を使ったデプロイを推奨します。Kubernetes のサポートは実験的なものです。Kubernetes を使用するでは、1 つまたは複数のレプリカでテストしたマニフェストを紹介していますが、クラスターを使うと運用の複雑さやメンテナンスの手間が増えます。Sandboxed Compiles は Docker ソケットを介してコンパイル用コンテナを作成するため、Ayakaleaf Pro を実行するすべてのノードに Docker Engine が必要です。CRI-O、Podman、Quadlet 用の設定は提供していません。
水平スケーリング ガイドを参照してください。複数の Overleaf インスタンスをデプロイし、ロードバランサーを設定してトラフィックを分散できます。
既存の Overleaf Server Pro インスタンスをお持ちの場合は、Ayakaleaf Pro への移行を喜んでお手伝いします。メールまたは issue でご連絡ください。
いいえ。Ayakaleaf Pro はドメインのルートから配信する必要があります。https://overleaf.example.com のような専用のドメインまたはサブドメインを使用してください。
はい。Toolkit は Linux、Docker Desktop を使用した macOS、WSL 2 と Docker Desktop を使用した Windows で動作します。共有サーバーや本番サーバーには Linux をおすすめします。macOS と Windows のガイドには、サンドボックスコンパイルのセットアップも含まれています。単体の docker-compose.yml は提供していません。Toolkit が使用する Compose の設定を確認するには、Toolkit ディレクトリで bin/docker-compose config を実行してください。
アンインストール用のスクリプトはありません。Toolkit ディレクトリで次の操作を行います。
  1. bin/docker-compose down でコンテナを停止して削除します。
  2. データを削除します。デフォルトでは Toolkit の data/ ディレクトリにあります。config/overleaf.rc で OVERLEAF_DATA_PATH、MONGO_DATA_PATH、REDIS_DATA_PATH、GIT_BRIDGE_DATA_PATH を変更している場合は、それらのディレクトリも削除してください。この操作は元に戻せないため、データが必要になる可能性がある場合は、まずバックアップを取ってください。
  3. Toolkit ディレクトリを削除します。
  4. docker images で一覧表示できる Docker イメージ(ghcr.io/ayaka-notes/overleaf-pro、git-bridge イメージ、mongo、redis、TeX Live イメージ)を削除します。
Toolkit ディレクトリで次を実行します。
  • bin/stop はすべてのコンテナを停止し、bin/start はそれらを再び起動します。コンテナは保持されるため、ユーザーはログインしたままになります。
  • bin/up -d はコンテナを作成し、バックグラウンドで起動します。config/variables.env、config/overleaf.rc、config/version を変更した後に実行してください。設定が変更されたコンテナが再作成され、その時点で初めて変更が反映されます。bin/stop と bin/start では変更は適用されません。
  • bin/docker-compose restart sharelatex は、設定の変更を適用せずに Overleaf コンテナのみを再起動します。
bin/up がコンテナを再作成するたびにユーザーがログアウトされる場合は、OVERLEAF_SESSION_SECRET を設定してください。環境変数の Q&A を参照してください。
Ayakaleaf Pro ではなく、プロバイダー側で作成するアプリケーションに設定します。これらの連携のいずれについても、config/variables.env にコールバックの設定はありません。Ayakaleaf Pro はすべてのコールバック URL を OVERLEAF_SITE_URL から構築してプロバイダーに送信し、プロバイダーはアプリケーションに登録されたものと一致しない限りそれを拒否します。そのため、プロバイダー側で登録し、OVERLEAF_SITE_URL をユーザーが開くアドレスに設定するだけで済みます。OVERLEAF_SITE_URL を新しいドメインなどに変更した場合は、すべてのプロバイダーで URL も更新してください。そうしないと連携に失敗します。
デフォルトでは、すべてのデータはサーバーのローカルディスク上、Toolkit の data/ ディレクトリに保存されます: data/overleaf(プロジェクトファイル、履歴、コンパイル出力)、data/mongo、data/redis。ユーザー数が 1000 人未満のインスタンスでは、定期的なバックアップを伴うローカルディスクの使用を推奨します。Ayakaleaf Pro のイメージは約 5 GB です。はじめにに記載されている最低 40 GB は Sandboxed Compiles 用で、その texlive-full イメージはそれぞれ約 28 GB あります。Sandboxed Compiles を使わない場合、コンパイルは sharelatex コンテナ内で TeX Live の basic スキームと latexmk、texcount、synctex、etoolbox、xetex を使って実行されるため、多くのプロジェクトがパッケージ不足で失敗します。その後、data/ ディレクトリはプロジェクトとその履歴に応じて増えていきます。du -sh data/* で確認してください。
はい。Windows がスリープせず、Docker Desktop が実行され続けていれば可能です。Start Docker Desktop when you sign in to your computer をオンにし、Toolkit の restart: always ポリシーを維持し、AC 電源接続時の自動スリープと休止状態を無効にしてください。画面はオフになってもかまいません。ノート PC の蓋を閉じたときの動作は別の設定です。bin/up -d の後に Ubuntu のターミナルを閉じても、デタッチされたコンテナは停止しません。Docker Desktop の終了、エンジンの一時停止、wsl --shutdown の実行はサービスを中断させます。Docker Desktop の Resource Saver は Windows のスリープとは異なります。コンテナが 1 つも実行されていないときに適用されるため、実行中の Ayakaleaf スタックは、誰も編集していないというだけではアイドル状態になりません。Windows を再起動した後は、ログイン時の起動設定があっても、誰かがサインインする必要があります。確認と復旧の手順については、インスタンスを利用可能な状態に保つに従ってください。可用性が対話的なデスクトップへのログインに依存してはならない場合は、引き続き Linux をおすすめします。
このガイドでは WSL 2 バックエンドを使用します。BIOS/UEFI で CPU の仮想化が有効になっていること、Windows の Virtual Machine Platform 機能、正常に動作する WSL 2 のインストールが必要です。完全な Hyper-V 機能は Docker Desktop の別のバックエンドであり、この WSL の構成の前提条件ではありません。タスク マネージャー → パフォーマンス → CPU → 仮想化 と、PowerShell での wsl --list --verbose を確認してください。0x80370102 などのエラーは、仮想化、Windows の機能、またはブート時のハイパーバイザーが無効になっていることを意味する場合があります。Microsoft と Docker の修復リンクを含む Windows のインストールのトラブルシューティング手順を参照してください。必要な機能を有効にした後は Windows を再起動してください。起動しない Docker エンジンは、Ayakaleaf を再インストールしても解決できません。

LaTeX

Sandbox Compiles を有効にすると、各ユーザーのコンパイルは個別の Docker コンテナで実行され、他のユーザーのコンパイルから分離されます。Sandbox Compiles では、Shell Escape はデフォルトで有効になっています。
私たちは過去 3 年間にわたり、Sandbox Compiles 用の TeX Live Full イメージを改善してきました。ほとんどの場合、overleaf.com でコンパイルできるプロジェクトは Ayakaleaf Pro でも正しくコンパイルされます。必要なフォントが利用できない場合は、そのフォントを手動でプロジェクトにアップロードしてください。
プロジェクトを Overleaf 公式サイトにアップロードし、読み取り専用のリンク共有を有効にして、そのリンクを GitHub の issue に記載してください。Overleaf 公式サイトでは正常にコンパイルできるのに Ayakaleaf Pro ではコンパイルできない原因となっているバグについては、調査して修正します。この範囲外のコンパイルの問題はサポートの対象外です。
最終更新日 2026年11月8日