メインコンテンツへスキップ
以前のバージョンを使用している場合は、パス名の overleaf の代わりに sharelatex を使用してください。
Overleaf コンテナに NFS ファイルシステムをマウントすることは技術的には可能ですが、推奨されません。さまざまな種類のパフォーマンス上のエラーが発生する可能性があります。コンパイル時によく見られるエラーの 1 つは次のとおりです。
特に、コンパイルデータ用のディレクトリのような一時的なデータに NFS ベースのファイルシステムを使用することはおすすめしません。以下のディレクトリには、ローカルのスクラッチディスク、できればローカルの SSD を使用することを推奨します。docker-compose ベースの構成では、NFS からのバインドマウントを上書きするだけにすることをおすすめします。これにより、アプリケーション内のパスを変更せずに済みます。以下は、/scratch にマウントされたスクラッチディスクを使用する docker-compose 設定の抜粋例です。
docker-compose excerpt
更新後に、既存のファイルを NFS から新しい場所へ移行する必要はありません。LaTeX コンパイラーは、フルコンパイルを再度実行することですべてのファイルを再作成できます。詳細は次を参照してください: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem
Windows または macOS で Overleaf を実行している場合、mongo サービスが次のエラーで再起動に失敗することがあります。
Example error
これは、Windows でマウントされたディレクトリなど、MongoDB が必要とするセマンティクスを提供しないファイルシステムから MongoDB のデータをバインドマウントした場合に発生することがあります。WSL 2 を使用した Windows では、Toolkit を Ubuntu の Linux ホームディレクトリ以下に置き、デフォルトのバインドマウントを使用してください。プラットフォームガイドの MongoDB の確認項目を参照してください。Docker が管理するストレージが必要な新規インストールの場合は、次のオーバーライドで名前付きボリュームを使用します(MongoDB イメージのストレージに関するガイダンスを参照してください)。既存のインストールでは、マウントを変更してもデータは移行されません。切り替える前にデータベースとキャッシュをバックアップして復元してください。そうしないと、サービスからは空のボリュームが見えることになります。既存の設定とマージしながら、config/docker-compose.override.yml に以下を追加してください:
config/docker-compose.override.yml
詳細は次を参照してください: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting
docker logs redis コマンドを使用してログのコピーを出力します。Fatal: Can't initialize Background Jobs という行が表示される場合、出力全体は次のようになります。
Redis log example
これは現在使用している Docker のバージョンに関連している可能性があります。バージョン 20.10.10 以上に更新すると、この問題は解決するはずです。詳細は Redis のアップストリームの issue を参照してください: https://github.com/redis/redis/issues/12362参考: https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop
Community Edition では、すべてのコンパイルが同じ sharelatex コンテナ内で行われるため、\write18 コマンドはデフォルトで無効になっています。これはより安全なデフォルト設定です。pdflatex で有効にしたい場合は、プロジェクトのルートに次の内容で latexmkrc ファイルを作成してください。
latexmkrc
その後、再コンパイルしてみてください。参考: https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape
これらのエラーは、mongo コンテナがクラッシュと再起動を繰り返していることを意味します。bin/up は MongoDB を起動してからその中でコマンドを実行しますが、コンテナの再起動中にそれが失敗します。bin/docker-compose ps では、mongo サービスが Restarting と表示されます。実際の原因を特定するには、MongoDB のログを確認します。
よくある原因は次のとおりです。
  • CPU が AVX に対応していない。MongoDB 5.0 以降は x86-64 で AVX を必要とし、ログには MongoDB 5.0+ requires a CPU with AVX support と表示されます。仮想マシンでは、AVX がパススルーされるように CPU タイプを host に設定してください。
  • Linux カーネル 6.19 から 7.0.13。MongoDB はこれらのカーネルでは起動を拒否します。回避策についてはソフトウェア要件を参照してください。
  • データが古いバージョンの MongoDB で作成されている。MongoDB 8.0 は 4.4 や 5.0 のデータを直接開くことができません。メジャーバージョンを 1 つずつアップグレードしてください。MongoDB の更新を参照してください。
これは Ayakaleaf Pro では想定された動作であり、無視してかまいません。このメッセージは OVERLEAF_IS_SERVER_PRO が true でない場合に出力され、Ayakaleaf Pro のイメージではそれに該当します。Ayakaleaf Pro はこの変数を必要としないため、未設定のままにしてください。
Overleaf が起動する前に、コンテナは起動時のチェックを実行し、いずれかが失敗すると終了します。Toolkit はコンテナを restart: always で実行するため、Docker がコンテナを再び起動し、同じチェックが再び失敗します。起動時の出力に、失敗したチェックの名前が表示されます。
よくある原因は次のとおりです。
  • Missing required secrets: config/variables.env で OVERLEAF_INVITE_TOKEN_SECRET を設定してください。環境変数を参照してください。
  • ShareLaTeX to Overleaf rebranding: 設定でまだ SHARELATEX_ の変数やパスが使われています。メッセージの指示に従って名前を変更してください。
  • Checking can connect to mongo and redis の後のエラー: Overleaf が MongoDB または Redis に接続できません。bin/logs mongo と bin/logs redis を確認してください。
原因を修正したら、bin/up -d を実行してください。
コンテナは起動のたびに起動スクリプトを順番に実行し、ログにはそれぞれが *** Running /etc/my_init.d/<script>... として記録されます。910_initiate_doc_version_recovery が処理を行うのは、かつて Overleaf 5.0.1 を実行していたインスタンスだけです。それ以外のインスタンスでは No recovery of doc versions needed. と出力され、起動はそのまま続行されます。その出力は OVERLEAF_DATA_PATH 内の data/history/doc-version-recovery.log にも書き込まれます。終了コードと bin/docker-compose logs --tail=100 sharelatex の末尾から、何が起きたかがわかります:
  • 終了コード 2 で、ログが *** Init system aborted. で終わっている場合: bin/stop、docker stop、bin/up での Ctrl+C などによってコンテナが停止されました。最後の Running 行のスクリプトは、その時点で実行中だったものにすぎず、失敗したわけではありません。bin/up -d でコンテナを再度起動し、起動が完了するまで待ってください。
  • 終了コード 1 で、ログに *** /etc/my_init.d/<script> failed with status <n> と表示されている場合: そのスクリプトが失敗しており、エラーはその直前の行にあります。910_initiate_doc_version_recovery が Detected unflushed changes while recovering doc versions で失敗した場合、そのインスタンスは 5.0.1 を実行しており、まだフラッシュされていない編集が残っています。公式の Doc version recovery ガイドに従ってください。
このページは、アカウントにログインしているものの、そのページを開く権限がない場合に表示されます。たとえば、管理者ではないアカウントで管理ページを開いた場合や、自分と共有されていないプロジェクトを開いた場合です。管理ページを開くには、管理者アカウントでログインしてください。既存の管理者が別のアカウントを管理者にすることもできますし、create-user --admin コマンドで管理者アカウントを作成することもできます。ユーザー管理を参照してください。開発環境(develop/)では、管理ページを使うには develop/dev.env に ADMIN_PRIVILEGE_AVAILABLE=true も必要です。Ayakaleaf Pro のイメージではすでに設定されています。
最終更新日 2026年11月8日