Başlatma invalid command code hatasıyla başarısız oluyor
bin/init, macOS’un BSD sed’ini bulduğunda sed: ... invalid command code bildirir. GNU sed’i 1. Toolkit’i İndirin bölümündeki gibi PATH üzerine koyun ve sed --version çıktısını kontrol edin.
Başarısız bir başlatma, config/ içindeki üç dosyanın tümünü boş bir OVERLEAF_INVITE_TOKEN_SECRET ile bırakabilir. Bu durumda bin/init yeniden çalıştırıldığında Config files already exist bildirir. Hiç başlatılmamış yeni bir kurulum için üç dosyayı bir yedek dizinine taşıyın ve bin/init komutunu yeniden çalıştırın. Mevcut bir örnek için yapılandırmasını ve gizli anahtarlarını koruyun; bin/init yeniden çalışsın diye dosyalarını silmeyin.
MongoDB sürekli yeniden başlıyor
MongoDB günlüklerini ve Docker sanal makinesinin çekirdek sürümünü okuyun:
Günlük Linux çekirdeği uyumsuzluğundan bahsediyorsa Docker sanal makinesinin Linux çekirdeğini kontrol edin adımını izleyin ve bin/up -d komutunu yeniden çalıştırın. Tek başına 137 çıkış kodu, MongoDB’nin belleğinin tükendiğini kanıtlamaz: konteyner durumunu ve günlükleri kontrol edin. Docker Desktop üzerindeki daha eski bir MongoDB sorunu için ayrıca bkz. Sorun Giderme.
Docker daemon’a bağlanılamıyor
Docker Desktop’ı başlatın ve seçili Docker bağlamını kontrol edin; bkz. 0. Docker Desktop Kurulumu. docker info çalışıyor ancak derlemeler Docker’a ulaşamıyorsa config/overleaf.rc içindeki soket ayarlarını kontrol edin ve clsi günlüklerini okuyun. Mac’te çalışan bir Docker CLI, uygulamanın soket bağlamasının doğru olduğunu kanıtlamaz.
Sayfa açılıyor ancak derlemeler başarısız oluyor
TeX Live imajının yerel olarak mevcut olduğunu ve Docker motorunun mimarisiyle eşleştiğini kontrol edin:
Apple silicon üzerinde imaj linux/arm64 olmalıdır. SERVER_PRO ve SIBLING_CONTAINERS_ENABLED değerlerinin her ikisinin de true olduğunu kontrol edin, ardından değişiklikleri bin/up -d ile uygulayın. Günlükler eksik bir derleme dizini bildiriyorsa Docker Desktop’ın dosya paylaşımını ve OVERLEAF_DATA_PATH konumunu kontrol edin. Bir bağlama hatasını gizlemek için korumalı alan derlemelerini kapatmayın.
Not a directory hatası veya eksik bir bind mount
Bir override dosyasının bağladığı bir ana bilgisayar dosyası silinmiş olabilir veya Docker, dosyanın olması gereken yerde bir dizin oluşturmuş olabilir. Ana bilgisayardaki kaynak yolu ve bağlamanın bir dosya mı yoksa dizin mi beklediğini kontrol edin. Konteyneri yeniden oluşturmadan önce yapılandırma dosyasını geri yükleyin. /tmp altındaki bir kurulum, macOS geçici dosyaları kaldırdıktan sonra bu sorunla karşılaşabilir.
Port veya konteyner adı çakışmaları
8080 portu kullanımdaysa config/overleaf.rc içinde başka bir port seçin, OVERLEAF_SITE_URL değerini buna uygun şekilde ayarlayın ve bin/up -d komutunu yeniden çalıştırın.
Toolkit, konteynerlerine sharelatex, mongo ve redis gibi sabit adlar verir. Yalnızca PROJECT_NAME değerini değiştirmek iki Toolkit kurulumunu birbirinden bağımsız hale getirmez. İkinci bir örneği başlatmadan önce docker ps -a çıktısını kontrol edin ve bir Compose override dosyasında başka konteyner adları, başka bir port ve ayrı veri dizinleri kullanın. Bir ad çakışmasını çözmek için mevcut bir dağıtımın konteynerlerini veya verilerini kaldırmayın.
Örneğe bir süre sonra erişilemiyor
Mac büyük olasılıkla uyku moduna geçti veya Docker Desktop kapatıldı. Bkz. Örneği erişilebilir tutun.
bin/doctor bunun Linux olmadığını söylüyor veya Quay oturumu istiyor
Her iki uyarı da herkese açık imajla macOS’ta beklenen bir durumdur; bkz. 2. Toolkit’i tanıyın. Bunun yerine imaj çekme işlemlerini, hizmet durumunu ve derleme sonuçlarını kontrol edin ve rapordaki diğer hataları göz ardı etmeyin.Son değiştirilme tarihi 8 Kasım 2026
