> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-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 NFS dosya sistemini bir Overleaf kapsayıcısına bağlamak teknik olarak mümkündür, ancak önerilmez ve farklı türde performans hatalarına yol açabilir.

Derlemelerde görülen yaygın hatalardan biri şudur:

```
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 verilerde NFS tabanlı dosya sistemlerinin kullanılmasını önermiyoruz. Aşağıdaki dizinler için yerel bir geçici disk, tercihen yerel bir SSD kullanmanızı öneririz.

İçin `docker-compose` tabanlı kurulumlar için, uygulamadaki yolları değiştirmekten kaçınan NFS'den bağlama noktasını geçersiz kılmanızı öneririz. İşte bir `docker-compose` ile bağlı bir geçici disk kullanımı içeren bir `/scratch`:

{% code title="docker-compose alıntısı" %}

```yaml
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
```

{% endcode %}

Güncellemeden sonra NFS'deki mevcut dosyaları 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>

</details>

<details>

<summary>Overleaf'i Windows veya macOS'ta çalıştırmak `mongo` hizmetinin başlamamasıyla sonuçlanır</summary>

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

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

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

{% endcode %}

Bu hatayı önlemek için verilerin, bağlanmış bir dizin yerine bir birimde saklanması gerekir (daha fazla ayrıntı için `mongo` görsel belgelere bakın: <https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data>). Verileri MongoDB ve Redis kapsayıcılarının içine bağlanan Docker birimlerinde saklamak için aşağıdakileri `config/docker-compose.override.yml` (henüz yoksa bu dosyayı oluşturun):

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

```yaml
volumes:
  mongo-data:
  redis-data:

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

  redis:
    volumes:
      - 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 bir yeniden başlatma döngüsüne yol açar</summary>

Günlüğün bir kopyasını çıktılamak için `docker logs redis` komutunu kullanın.

Şu satırı görürseniz `Ölümcül: Arka Plan İşleri başlatılamıyor`, tam çıktı aşağıdakine benzer 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 # Ölümcül: Arka Plan İşleri başlatılamıyor.
1:C 11 Şub 2024 15:19:26.055 # oO0OoO0OoO0OoOoO0OoO0OoO0Oo Redis başlatılıyor oO0OoO0OoO0Oo
```

{% endcode %}

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

Daha fazla bilgi için Redis üst akış sorununa bakın: <https://github.com/redis/redis/issues/12362>

Başvuru: <https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop>

</details>

<details>

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

Zaman zaman Server Pro tarafından oluşturulan önizleme/küçük resim görüntüleri yanlış yönde oluşturulabilir ve düzeltmek için manuel müdahale gerektirebilir. 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 eski).

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İstansınızın ş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 bilgisayarından ç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}"

Başvuru: <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, tüm derlemeler aynı `sharelatex` kapsayıcı içinde gerçekleştiği için Community Edition'da varsayılan olarak devre dışıdır; bu daha güvenli varsayılandır.

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

{% code title="latexmkrc" %}

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

{% endcode %}

Sonra yeniden derlemeyi deneyin.

Başvuru: <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://ayakaleaf-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.