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

# Pemecahan masalah

<Info>
  Jika Anda menggunakan versi yang lebih lama, gunakan `sharelatex` alih-alih `overleaf` pada nama path.
</Info>

<Accordion title="Menjalankan Overleaf dengan sistem file NFS">
  Me-mount sistem file NFS di kontainer Overleaf secara teknis memungkinkan, tetapi tidak disarankan dan dapat mengakibatkan berbagai jenis masalah performa.

  Salah satu error umum yang terjadi saat kompilasi adalah:

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

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

  Untuk penyiapan berbasis `docker-compose`, kami menyarankan cukup menimpa bind-mount dari NFS, sehingga tidak perlu mengubah path di aplikasi. Berikut contoh potongan konfigurasi `docker-compose` yang menggunakan disk scratch yang di-mount di `/scratch`:

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

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

  Untuk detail lebih lanjut, lihat: [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="Menjalankan Overleaf di Windows atau macOS menyebabkan layanan `mongo` tidak dapat dijalankan">
  Jika Anda menjalankan Overleaf di Windows atau macOS, layanan `mongo` mungkin gagal dimulai ulang, dengan error:

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

  Untuk menghindari error ini, data perlu disimpan di volume, bukan di direktori bind mount (lihat dokumentasi image `mongo` untuk detail lebih lanjut: [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)). Untuk menyimpan data di dalam volume Docker yang di-mount di dalam kontainer MongoDB dan Redis, tambahkan yang berikut ke `config/docker-compose.override.yml` (buat file ini jika belum ada):

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

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

<Accordion title="Upgrade ke Redis 6.2 menyebabkan restart loop">
  Gunakan perintah `docker logs redis` untuk menampilkan salinan log.

  Jika Anda melihat baris `Fatal: Can't initialize Background Jobs`, output lengkapnya akan terlihat seperti ini:

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

  Hal ini mungkin terkait dengan versi Docker yang sedang digunakan. Memperbarui ke versi >= 20.10.10 seharusnya dapat menyelesaikan masalah ini.

  Untuk informasi lebih lanjut, lihat issue upstream Redis: [https://github.com/redis/redis/issues/12362](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](https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop)
</Accordion>

<Accordion title="Orientasi gambar pratinjau/thumbnail galeri templat yang salah">
  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/` (versi sebelumnya).

  Kami menyarankan untuk mem-backup folder ini sebelum melakukan perubahan apa pun.

  Anda perlu mengikuti langkah-langkah di bawah ini untuk setiap templat yang terpengaruh:

  Temukan ID templatBuka galeri templat instans Anda (/templates/all), buka templat yang terpengaruh, dan salin ID dari URL (misalnya: [https://your-instance-url/templates/6645d346c224815e9460a695).Jalankan](https://your-instance-url/templates/6645d346c224815e9460a695\).Jalankan) perintah koreksiJalankan perintah berikut dari host Docker (ganti ID templat 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](https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images)
</Accordion>

<Accordion title="Please verify that you have enabled system calls. For pdflatex, this is 'pdflatex -shell-escape'.">
  Perintah `\write18` dinonaktifkan secara default di Community Edition karena semua kompilasi terjadi di dalam kontainer `sharelatex` yang sama; ini adalah default yang lebih aman.

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

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

  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](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.