> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/tr/destek/troubleshooting.md).

# Sorun giderme

{% hint style="info" %}
Daha eski bir sürüm kullanıyorsanız lütfen kullanın `sharelatex` yerine `overleaf` yol adlarında.
{% endhint %}

<details>

<summary>Overleaf'i bir NFS dosya sistemiyle çalıştırma</summary>

Bir Overleaf kapsayıcısına bir NFS dosya sistemi bağlamak teknik olarak mümkündür, ancak tavsiye edilmez ve çeşitli performans hatalarına yol açabilir.

Derlemelerde görülen yaygın bir hata:

```
EBUSY: kaynak meşgul veya kilitli, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'
```

Özellikle derleme verileri için kullanılan dizinler gibi geçici veriler için NFS destekli dosya sistemlerinin kullanılmasını önermiyoruz. Aşağıdaki dizinler için yerel bir scratch disk, tercihen yerel bir SSD kullanmanızı öneririz.

İçin `docker-compose` tabanlı kurulumlarda, NFS'den gelen bind-mount'u yalnızca üzerine yazmanızı öneririz; bu, uygulamadaki yolları değiştirmeyi önler. İşte bir `docker-compose` bir scratch disk kullanımıyla birlikte bağlandığı yer olan bir `/scratch`:

{% code title="docker-compose parçası" %}

```yaml
services:
  sharelatex:
    ortam:
      SANDBOXED_COMPILES_HOST_DIR: /scratch/compiles/
    birimler:
      - 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
```

{% endcode %}

Güncellemeden sonra NFS'deki mevcut dosyaları yeni konumlarına taşımaya 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>

</details>

<details>

<summary>Overleaf'i Windows veya macOS'ta çalıştırmak, `mongo` hizmetinin başlamamasına neden olur</summary>

Overleaf'i Windows veya macOS'ta çalıştırıyorsanız, `mongo` hizmet yeniden başlatılamayabilir; hata:

{% code title="Örnek hata" %}

```
WiredTiger herhangi bir uyumluluk sürümü altında başlatılamadı.
Sebep: 1: İşleme izin verilmiyor
```

{% endcode %}

Bu hatadan kaçınmak için verilerin bind ile bağlanmış bir dizin yerine bir birimde saklanması gerekir (bkz. `mongo` Daha fazla ayrıntı için görüntü belgelendirmesi: <https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data>). Verileri MongoDB ve Redis kapsayıcıları içinde bağlanan Docker birimlerinde saklamak için aşağıdakileri `config/docker-compose.override.yml` (bu dosya henüz yoksa oluşturun):

{% code title="config/docker-compose.override.yml" %}

```yaml
birimler:
  mongo-data:
  redis-data:

services:
  mongo:
    birimler:
      - mongo-data:/data/db

  redis:
    birimler:
      - redis-data:/data
```

{% endcode %}

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>

</details>

<details>

<summary>Redis 6.2'ye yükseltme, yeniden başlatma döngüsüne yol açar</summary>

Şunu kullanın `docker logs redis` komutunu, günlüklerin bir kopyasını çıktılamak için kullanın.

Şu satırı görürseniz `Kritik hata: Arka plan işleri başlatılamıyor`, tam çıktı aşağı yukarı şöyle görünür:

{% code title="Redis günlük örneği" %}

```
1:M 11 Şub 2024 15:19:22.609 # Sunucu başlatıldı
1:M 11 Şub 2024 15:19:22.609 # Kritik hata: Arka plan işleri başlatılamıyor.
1:C 11 Şub 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis başlatılıyor oO0OoO0OoO0Oo
```

{% endcode %}

Bu, şu anda kullanılan Docker sürümüyle ilgili olabilir. >= 20.10.10 sürümüne güncellemek bu sorunu çözmelidir.

Daha fazla bilgi için Redis upstream sorununa bakın: <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>

</details>

<details>

<summary>Şablon galerisi önizleme/küçük resim görüntülerinin yanlış yönelimi</summary>

Zaman zaman, Server Pro tarafından oluşturulan önizleme/küçük resim görüntüleri yanlış yönde oluşturulabilir ve düzeltilmesi için manuel müdahale gerekebilir. Bu görüntüler şurada saklanır: `/var/lib/overleaf/data/template_files/` (>= 5.0.3) ve `/var/lib/sharelatex/data/template_files/` (daha önceki sürümlerde).

Herhangi bir değişiklik yapmadan önce bu klasörü yedeklemenizi öneririz.

Etkilenen her şablon için aşağıdaki adımları izlemeniz gerekecek:

Şablon kimliğini bulunÖrneğinizin şablon galerisine (/templates/all) gidin, etkilenen bir şablonu açın ve kimliği URL'den kopyalayın (örneğin: <https://your-instance-url/templates/6645d346c224815e9460a695).Düzeltme> komutunu çalıştırınAşağıdaki komutu Docker ana makinesinden ç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>

</details>

<details>

<summary>Lütfen sistem çağrılarını etkinleştirdiğinizi doğrulayın. pdflatex için bu, 'pdflatex -shell-escape' komutudur.</summary>

Bu `\write18` komutu, Community Edition'da varsayılan olarak devre dışıdır; çünkü tüm derlemeler aynı `sharelatex` kapsayıcı içinde gerçekleşir; bu daha güvenli bir varsayılandır.

Bunu pdflatex için etkinleştirmek istiyorsanız, bir `latexmkrc` dosyasını projenizin kök dizininde aşağıdaki içerikle oluşturun:

{% code title="latexmkrc" %}

```perl
$pdflatex = 'pdflatex --shell-escape';
```

{% endcode %}

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>

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/on-premises/tr/destek/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.