> 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/id/dukungan/troubleshooting.md).

# Pemecahan masalah

{% hint style="info" %}
Jika Anda menggunakan versi yang lebih lama, silakan gunakan `sharelatex` alih-alih `overleaf` dalam nama path.
{% endhint %}

<details>

<summary>Menjalankan Overleaf dengan sistem berkas NFS</summary>

Memasang sistem berkas NFS di kontainer Overleaf secara teknis dimungkinkan, tetapi tidak direkomendasikan dan dapat mengakibatkan berbagai jenis kesalahan kinerja.

Salah satu kesalahan umum yang terlihat saat kompilasi adalah:

```
EBUSY: resource sibuk atau terkunci, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'
```

Secara khusus, kami menyarankan untuk tidak menggunakan sistem berkas berbasis NFS untuk data sementara, seperti direktori yang digunakan untuk data kompilasi. Kami merekomendasikan penggunaan disk scratch lokal, sebaiknya SSD lokal untuk direktori berikut.

Untuk `docker-compose` berbasis, kami menyarankan untuk cukup menimpa bind-mount dari NFS, yang menghindari perubahan path di aplikasi. Berikut adalah contoh `docker-compose` cuplikan konfigurasi dengan penggunaan scratch disk yang di-mount di `/scratch`:

{% code title="cuplikan docker-compose" %}

```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 %}

Tidak perlu memigrasikan file apa pun yang sudah ada dari NFS ke lokasi barunya setelah pembaruan. Kompiler LaTeX dapat membuat ulang semua file dengan menjalankan kompilasi penuh lagi.

Untuk detail lebih lanjut, lihat: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem>

</details>

<details>

<summary>Menjalankan Overleaf di Windows atau macOS menyebabkan layanan `mongo` tidak dimulai</summary>

Jika Anda menjalankan Overleaf di Windows atau macOS, `mongo` layanan mungkin gagal dimulai ulang, dengan error:

{% code title="Contoh kesalahan" %}

```
Gagal memulai WiredTiger pada versi kompatibilitas mana pun.
Alasan: 1: Operasi tidak diizinkan
```

{% endcode %}

Untuk menghindari kesalahan ini, data perlu disimpan dalam volume alih-alih direktori bind mount (lihat `mongo` dokumentasi image untuk detail lebih lanjut: <https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data>). Untuk menyimpan data di dalam volume Docker yang di-mount di dalam kontainer MongoDB dan Redis, tambahkan berikut ke `config/docker-compose.override.yml` (buat file ini jika belum ada):

{% 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 %}

Untuk informasi lebih lanjut, lihat: <https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting>

</details>

<details>

<summary>Peningkatan ke Redis 6.2 menghasilkan loop restart</summary>

Gunakan `docker logs redis` perintah untuk menampilkan salinan log.

Jika Anda melihat baris `Fatal: Tidak dapat menginisialisasi Background Jobs`, output lengkapnya akan terlihat seperti ini:

{% code title="Contoh log Redis" %}

```
1:M 11 Feb 2024 15:19:22.609 # Server diinisialisasi
1:M 11 Feb 2024 15:19:22.609 # Fatal: Tidak dapat menginisialisasi Background Jobs.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis sedang memulai oO0OoO0OoO0Oo
```

{% endcode %}

Ini mungkin terkait dengan versi Docker yang saat ini digunakan. Memperbarui ke versi >= 20.10.10 seharusnya menyelesaikan masalah ini.

Untuk informasi lebih lanjut, lihat issue hulu Redis: <https://github.com/redis/redis/issues/12362>

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

</details>

<details>

<summary>Orientasi yang salah pada gambar pratinjau/thumbnail galeri template</summary>

Kadang-kadang, gambar pratinjau/thumbnail yang dihasilkan oleh Server Pro dapat dibuat dengan orientasi yang salah dan memerlukan intervensi manual untuk memperbaikinya. Gambar-gambar ini disimpan di `/var/lib/overleaf/data/template_files/` (>= 5.0.3) dan `/var/lib/sharelatex/data/template_files/` (lebih awal).

Kami menyarankan untuk mencadangkan folder ini sebelum membuat perubahan apa pun.

Anda perlu mengikuti langkah-langkah di bawah ini untuk setiap template yang terdampak:

Temukan ID templateBuka galeri template pada instance Anda (/templates/all), buka template yang terdampak, dan salin ID dari URL (misalnya: <https://your-instance-url/templates/6645d346c224815e9460a695).Jalankan> perintah perbaikanJalankan perintah berikut dari host Docker (ganti ID template dengan yang Anda salin dan perbarui path jika perlu):docker exec sharelatex /bin/bash -c "mogrify -rotate 90 /var/lib/overleaf/data/template\_files/6645d346c224815e9460a695\_\*{thumbnail,preview}"

Referensi: <https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images>

</details>

<details>

<summary>Harap verifikasi bahwa Anda telah mengaktifkan system calls. Untuk pdflatex, ini adalah 'pdflatex -shell-escape'.</summary>

Bagian `\write18` perintah dinonaktifkan secara default dalam Edisi Komunitas karena semua kompilasi terjadi di dalam kontainer yang sama `sharelatex` kontainer; ini adalah default yang lebih aman.

Jika Anda ingin mengaktifkannya untuk pdflatex, buatlah sebuah `latexmkrc` file di root proyek Anda dengan konten berikut:

{% code title="latexmkrc" %}

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

{% endcode %}

Lalu coba kompilasi ulang.

Referensi: <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/id/dukungan/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.