> ## 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

<Info>
  Daha eski bir sürüm kullanıyorsanız, yol adlarında `overleaf` yerine lütfen `sharelatex` kullanın.
</Info>

<Accordion title="Overleaf'i NFS dosya sistemiyle çalıştırma">
  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:

  ```text theme={null}
  EBUSY: resource busy or locked, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'
  ```

  Ö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:

  ```yaml title="docker-compose excerpt" theme={null}
  services:
    sharelatex:
      environment:
        SANDBOXED_COMPILES_HOST_DIR: /scratch/compiles/
      volumes:
        - nfs:/var/lib/overleaf/data
        - /scratch/cache/:/var/lib/overleaf/data/cache
        - /scratch/compiles/:/var/lib/overleaf/data/compiles
        - /scratch/output/:/var/lib/overleaf/data/output
        - /scratch/tmp/:/var/lib/overleaf/tmp
  ```

  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](https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem)
</Accordion>

<Accordion title="Overleaf'i Windows veya macOS üzerinde çalıştırmak `mongo` hizmetinin başlamamasına neden oluyor">
  Overleaf'i Windows veya macOS üzerinde çalıştırıyorsanız `mongo` hizmeti şu hatayla yeniden başlatılamayabilir:

  ```text title="Example error" theme={null}
  Failed to start up WiredTiger under any compatibility version.
  Reason: 1: Operation not permitted
  ```

  Bu hatayı önlemek için verilerin bind mount ile bağlanmış bir dizin yerine bir birimde (volume) saklanması gerekir (daha fazla ayrıntı için `mongo` imajı belgelerine bakın: [https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data](https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data)). Verileri MongoDB ve Redis konteynerlerine bağlanan Docker birimlerinde saklamak için `config/docker-compose.override.yml` dosyasına aşağıdakileri ekleyin (bu dosya henüz yoksa oluşturun):

  ```yaml title="config/docker-compose.override.yml" theme={null}
  volumes:
    mongo-data:
    redis-data:

  services:
    mongo:
      volumes:
        - mongo-data:/data/db

    redis:
      volumes:
        - redis-data:/data
  ```

  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](https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting)
</Accordion>

<Accordion title="Redis 6.2'ye yükseltme yeniden başlatma döngüsüne neden oluyor">
  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:

  ```text title="Redis log example" theme={null}
  1:M 11 Feb 2024 15:19:22.609 # Server initialized
  1:M 11 Feb 2024 15:19:22.609 # Fatal: Can't initialize Background Jobs.
  1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0Oo
  ```

  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/12362](https://github.com/redis/redis/issues/12362)

  Kaynak: [https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop](https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop)
</Accordion>

<Accordion title="Şablon galerisi önizleme/küçük resim görsellerinin yanlış yönlendirmesi">
  Zaman zaman Server 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/` (>= 5.0.3) ve `/var/lib/sharelatex/data/template_files/` (daha eski sürümler) konumlarında 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](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](https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images)
</Accordion>

<Accordion title="Lütfen sistem çağrılarını etkinleştirdiğinizi doğrulayın. pdflatex için bu 'pdflatex -shell-escape' şeklindedir.">
  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:

  ```perl title="latexmkrc" theme={null}
  $pdflatex = 'pdflatex --shell-escape';
  ```

  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](https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape)
</Accordion>


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