Ana içeriğe atla
Daha eski bir sürüm kullanıyorsanız, yol adlarında overleaf yerine lütfen sharelatex kullanın.
Bir Overleaf konteynerine NFS dosya sistemi bağlamak teknik olarak mümkündür; ancak önerilmez ve farklı türde performans hatalarına yol açabilir.Derlemelerde sık görülen hatalardan biri şudur:
Özellikle derleme verileri için kullanılan dizinler gibi geçici veriler için NFS tabanlı dosya sistemlerinin kullanılmamasını öneririz. Aşağıdaki dizinler için yerel bir geçici disk, tercihen yerel bir SSD kullanmanızı öneririz.docker-compose tabanlı kurulumlarda, uygulamadaki yolları değiştirmek zorunda kalmamak için NFS’ten gelen bind-mount’u geçersiz kılmanızı öneririz. Aşağıda /scratch konumuna bağlanmış bir geçici disk kullanan bir docker-compose yapılandırması alıntısı örneği verilmiştir:
docker-compose excerpt
Güncellemeden sonra mevcut dosyaları NFS’ten yeni konumlarına taşımanıza gerek yoktur. LaTeX derleyicisi, tam bir derleme çalıştırmasıyla tüm dosyaları yeniden oluşturabilir.Daha fazla ayrıntı için bkz.: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem
Overleaf’i Windows veya macOS üzerinde çalıştırıyorsanız mongo hizmeti şu hatayla yeniden başlatılamayabilir:
Example error
Bu durum, MongoDB verileri Windows’tan bağlanmış bir dizin gibi gerekli semantiği sağlamayan bir dosya sisteminden bind mount ile bağlandığında ortaya çıkabilir. WSL 2 ile Windows için Toolkit’i Ubuntu’nun Linux ana dizini altında tutun ve varsayılan bind mount’ları kullanın. Platform kılavuzundaki MongoDB kontrollerine bakın.Docker tarafından yönetilen depolamaya ihtiyaç duyan yeni bir kurulum için aşağıdaki override, adlandırılmış birimler (named volumes) kullanır (bkz. MongoDB imajı depolama önerileri). Mevcut bir kurulumda bağlamaları değiştirmek verileri taşımaz: geçiş yapmadan önce veritabanını/önbelleği yedekleyip geri yükleyin, aksi halde hizmet boş birimler görür. Bunu mevcut yapılandırmayla birleştirerek config/docker-compose.override.yml dosyasına ekleyin:
config/docker-compose.override.yml
Daha fazla bilgi için bkz.: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting
Günlüklerin bir kopyasını çıktı olarak almak için docker logs redis komutunu kullanın.Fatal: Can't initialize Background Jobs satırını görüyorsanız, tam çıktı aşağı yukarı şöyle görünür:
Redis log example
Bu durum, şu anda kullanılan Docker sürümüyle ilgili olabilir. 20.10.10 veya daha yeni bir sürüme güncellemek bu sorunu çözmelidir.Daha fazla bilgi için Redis’in upstream sorun kaydına bakın: https://github.com/redis/redis/issues/12362Kaynak: https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop
Zaman zaman Ayakaleaf Pro tarafından oluşturulan önizleme/küçük resim görselleri yanlış yönde oluşturulabilir ve düzeltilmeleri için el ile müdahale gerekebilir. Bu görseller /var/lib/overleaf/data/template_files/ konumunda saklanır.Herhangi bir değişiklik yapmadan önce bu klasörü yedeklemenizi öneririz.Etkilenen her şablon için aşağıdaki adımları izlemeniz gerekir:Şablon kimliğini bulunÖrneğinizin şablon galerisine (/templates/all) gidin, etkilenen bir şablonu açın ve URL’deki kimliği kopyalayın (örneğin: https://your-instance-url/templates/6645d346c224815e9460a695).Düzeltme komutunu çalıştırınDocker ana bilgisayarından aşağıdaki komutu çalıştırın (şablon kimliğini kopyaladığınız kimlikle değiştirin ve gerekirse yolu güncelleyin):docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”Kaynak: https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images
Tüm derlemeler aynı sharelatex konteyneri içinde gerçekleştiğinden, Community Edition’da \write18 komutu varsayılan olarak devre dışıdır; bu daha güvenli bir varsayılandır.pdflatex için etkinleştirmek istiyorsanız, projenizin kök dizininde aşağıdaki içeriğe sahip bir latexmkrc dosyası oluşturun:
latexmkrc
Ardından yeniden derlemeyi deneyin.Kaynak: https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape
Bu hatalar, mongo konteynerinin sürekli çöküp yeniden başladığı anlamına gelir. bin/up MongoDB’yi başlatır ve ardından içinde bir komut çalıştırır; konteyner yeniden başlarken bu komut başarısız olur. bin/docker-compose ps, mongo hizmetini Restarting olarak gösterir.Asıl nedeni bulmak için MongoDB günlüğünü okuyun:
Yaygın nedenler şunlardır:
  • CPU’nun AVX desteği yoktur. MongoDB 5.0 ve sonraki sürümler x86-64 üzerinde AVX gerektirir ve günlükte MongoDB 5.0+ requires a CPU with AVX support görünür. Bir sanal makinede, AVX’in aktarılması için CPU türünü host olarak ayarlayın.
  • Linux çekirdeği 6.19 ile 7.0.13 arası. MongoDB bu çekirdeklerde başlamayı reddeder. Geçici çözüm için bkz. Yazılım gereksinimleri.
  • Veriler daha eski bir MongoDB sürümüyle oluşturulmuştur. MongoDB 8.0, 4.4 veya 5.0 sürümlerinden gelen verileri doğrudan açamaz. Her seferinde bir ana sürüm yükseltin; bkz. MongoDB’yi güncelleme.
Bu, Ayakaleaf Pro’da beklenen bir durumdur ve görmezden gelebilirsiniz. Mesaj, OVERLEAF_IS_SERVER_PRO değeri true olmadığında yazdırılır; Ayakaleaf Pro imajında durum budur. Ayakaleaf Pro bu değişkene ihtiyaç duymaz, bu nedenle ayarlamadan bırakın.
Overleaf başlamadan önce konteyner başlangıç denetimleri çalıştırır ve bunlardan biri başarısız olduğunda kapanır. Toolkit konteyneri restart: always ile çalıştırır; bu nedenle Docker onu yeniden başlatır ve aynı denetim yine başarısız olur. Başlangıç çıktısı başarısız olan denetimin adını verir:
Yaygın nedenler şunlardır:
  • Missing required secrets: config/variables.env dosyasında OVERLEAF_INVITE_TOKEN_SECRET değerini ayarlayın, bkz. Ortam değişkenleri.
  • ShareLaTeX to Overleaf rebranding: yapılandırma hâlâ SHARELATEX_ değişkenlerini veya yollarını kullanıyor; bunları mesajda belirtildiği gibi yeniden adlandırın.
  • Checking can connect to mongo and redis sonrasında bir hata: Overleaf MongoDB’ye veya Redis’e ulaşamıyor. bin/logs mongo ve bin/logs redis çıktılarını kontrol edin.
Nedeni düzelttikten sonra bin/up -d komutunu çalıştırın.
Konteyner her başlatmada başlangıç betiklerini art arda çalıştırır ve günlük her birini *** Running /etc/my_init.d/<script>... olarak adlandırır. 910_initiate_doc_version_recovery yalnızca bir zamanlar Overleaf 5.0.1 çalıştırmış örneklerde iş yapar. Diğer tüm örneklerde No recovery of doc versions needed. yazdırır ve başlatma devam eder. Çıktısı ayrıca OVERLEAF_DATA_PATH içindeki data/history/doc-version-recovery.log dosyasına da yazılır.Çıkış kodu ve bin/docker-compose logs --tail=100 sharelatex çıktısının sonu ne olduğunu gösterir:
  • Çıkış kodu 2 ve günlük *** Init system aborted. ile bitiyor: konteyner durduruldu; örneğin bin/stop, docker stop ile veya bin/up üzerinde Ctrl+C ile. Son Running satırındaki betik yalnızca o anda çalışmakta olandır, başarısız olmamıştır. Konteyneri bin/up -d ile yeniden başlatın ve başlatmanın tamamlanmasını bekleyin.
  • Çıkış kodu 1 ve günlük *** /etc/my_init.d/<script> failed with status <n> gösteriyor: o betik başarısız oldu ve hatası hemen üstteki satırlardadır. 910_initiate_doc_version_recovery, Detected unflushed changes while recovering doc versions hatasıyla başarısız olduysa örnek 5.0.1 çalıştırmıştır ve hâlâ diske yazılmamış düzenlemeleri vardır; resmi Doc version recovery kılavuzunu izleyin.
Bu sayfa, hesabınızda oturum açılmış olduğu ancak sayfayı açma izniniz olmadığı durumlarda gösterilir; örneğin yönetici olmayan bir hesapla açılan bir yönetici sayfası veya sizinle paylaşılmamış bir proje.Yönetici sayfalarını açmak için bir yönetici hesabıyla oturum açın. Mevcut bir yönetici başka bir hesabı yönetici yapabilir ya da create-user --admin komutuyla bir yönetici hesabı oluşturabilirsiniz, bkz. Kullanıcı yönetimi. Geliştirme ortamında (develop/) yönetici sayfaları ayrıca develop/dev.env dosyasında ADMIN_PRIVILEGE_AVAILABLE=true ayarını gerektirir; Ayakaleaf Pro imajı bunu zaten ayarlar.
Son değiştirilme tarihi 8 Kasım 2026