0. Docker Desktop Kurulumu

Mac’inize Docker Desktop’ı kurun ve motoru, kaynakları, dosya paylaşımını ve Docker soketini kontrol edin.

Ayakaleaf Pro, Docker üzerinde çalışır. Mac’te Docker motorunu bir Linux sanal makinesinde çalıştıran Docker Desktop’ı kullanırsınız.

1. Docker Desktop'ı kurun ve başlatın

   Mac’iniz için (Apple silicon veya Intel) uygun Docker Desktop sürümünü kurun, açın ve motor başlayana kadar bekleyin. Terminal’den de başlatabilirsiniz:

   open -a Docker
   
2. Docker motorunu kontrol edin

   Terminal’de şu komutları çalıştırın:

   docker context show
   docker info
   docker compose version
   

   Bağlam (context) yerel Docker Desktop motorunuzu, normalde desktop-linux bağlamını göstermelidir. Başka bir bağlam seçiliyse devam etmeden önce Docker Desktop’a geçin:

   docker context use desktop-linux
   

   docker info bir Server bölümü yazdırmalıdır. Tek başına docker --version yalnızca istemcinin kurulu olduğunu gösterir.

3. Kaynakları ve dosya paylaşımını kontrol edin

   Docker Desktop Settings içinde CPU, bellek ve disk sınırlarını Başlamadan önce bölümüne göre, ayrıca dosya paylaşımı ayarlarını kontrol edin; bkz. Docker Desktop ayarları.

   Bu kılavuz Toolkit’i, Docker Desktop’ın varsayılan olarak paylaştığı /Users altında tutar. Başka bir konum kullanırsanız ve bin/up komutu Mounts denied hatasıyla başarısız olursa, o dizini dosya paylaşımına ekleyin.

4. Korumalı alan derlemeleri için Docker soketini kontrol edin

   Toolkit, her derleme için ayrı bir TeX Live konteyneri başlatabilmesi amacıyla /var/run/docker.sock soketini uygulamaya bağlar (mount). config/overleaf.rc içinde DOCKER_SOCKET_PATH=/var/run/docker.sock ayarını koruyun.

   macOS’taki Docker CLI, ~/.docker/run/docker.sock üzerinden bağlanabilir. Bu, Mac’teki istemci uç noktasıdır ve Toolkit’in bağlama kaynağını değiştirmek için bir neden değildir: derleyicinin, Linux konteynerlerinin gördüğü şekliyle motor soketine ihtiyacı vardır.

   Mac’te /var/run/docker.sock yoksa Settings → Advanced altında Allow the default Docker socket to be used seçeneğini açın; bkz. Docker’ın izin gereksinimleri.

   Hataları aşmak için sokette chmod 777 çalıştırmayın. Docker soketine erişim, Docker sanal makinesine root eşdeğeri erişim demektir.

​

Sonraki adım

docker info çalıştığında 1. Toolkit’i İndirin adımıyla devam edin.