> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Sorun giderme

> Ayakaleaf Pro'yu macOS üzerinde Docker Desktop ile çalıştırırken görülen sorunlar ve bunların nasıl kontrol edileceği.

### 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](https://ayakaleaf-pro.mintlify.site/tr/on-premises/installation/using-docker-compose/macos/1.-download-the-toolkit.md) 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:

```bash theme={null}
bin/docker-compose logs --tail=100 mongo
docker info --format '{{.KernelVersion}}'
```

Günlük Linux çekirdeği uyumsuzluğundan bahsediyorsa [Docker sanal makinesinin Linux çekirdeğini kontrol edin](https://ayakaleaf-pro.mintlify.site/tr/on-premises/installation/using-docker-compose/macos/5.-personalizing-your-instance.md#check-the-docker-vms-linux-kernel) 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](https://ayakaleaf-pro.mintlify.site/tr/on-premises/support/troubleshooting.md).

### 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](https://ayakaleaf-pro.mintlify.site/tr/on-premises/installation/using-docker-compose/macos/0.-setup-docker-desktop.md). `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:

```bash theme={null}
docker image inspect ghcr.io/ayaka-notes/texlive-full:2026.1 \
  --format '{{.Os}}/{{.Architecture}}'
bin/logs -f clsi
```

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](https://ayakaleaf-pro.mintlify.site/tr/on-premises/installation/using-docker-compose/macos/6.-post-installation-tasks.md#keep-the-instance-available).

### `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](https://ayakaleaf-pro.mintlify.site/tr/on-premises/installation/using-docker-compose/macos/2.-familiarize-yourself-with-the-toolkit.md). Bunun yerine imaj çekme işlemlerini, hizmet durumunu ve derleme sonuçlarını kontrol edin ve rapordaki diğer hataları göz ardı etmeyin.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.