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

# Pemecahan masalah

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

<details>

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

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

Salah satu kesalahan umum yang terlihat saat kompilasi adalah:

```
EBUSY: resource busy or locked, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'
```

Secara khusus, kami tidak menyarankan penggunaan 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 hanya menimpa bind-mount dari NFS, yang menghindari perubahan path di aplikasi. Berikut adalah contoh `docker-compose` cuplikan konfigurasi dengan penggunaan disk scratch yang dipasang 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 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 dapat dimulai</summary>

Jika Anda menjalankan Overleaf di Windows atau macOS, `mongo` layanan dapat gagal untuk dimulai ulang, dengan kesalahan:

{% code title="Contoh kesalahan" %}

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

{% endcode %}

Untuk menghindari kesalahan ini, data perlu disimpan di dalam volume, bukan di direktori yang di-bind mount (lihat the `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 Docker volume yang dipasang di dalam kontainer MongoDB dan Redis, tambahkan berikut ini 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 mulai ulang</summary>

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

Jika Anda melihat baris `Fatal: Tidak dapat menginisialisasi Background Jobs`, keluaran 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 dimulai oO0OoO0OoO0Oo
```

{% endcode %}

Hal 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 masalah upstream 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>

Terkadang, 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/` (sebelumnya).

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

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

Temukan ID templateArahkan ke galeri template instans 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 sesuai):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 call. Untuk pdflatex, ini adalah 'pdflatex -shell-escape'.</summary>

Berikut `\write18` perintah dinonaktifkan secara default di Community Edition karena semua kompilasi terjadi di dalam kontainer yang sama `sharelatex` ; 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 %}

Kemudian 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://overleaf-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.