> 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/konfigurasi/overleaf-toolkit/files-and-locations.md).

# Berkas dan lokasi

Halaman ini menjelaskan file konfigurasi yang digunakan oleh Toolkit untuk mengonfigurasi deployment Overleaf on-premises Anda.

### Data Persisten

Overleaf Toolkit perlu menyimpan data persisten, seperti file yang diperlukan untuk mengompilasi proyek LaTeX, dan isi basis data MongoDB. Ini dilakukan dengan memasang beberapa direktori dari mesin host ke dalam kontainer Docker, lalu menulis data ke direktori tersebut.

#### Direktori Data

Berikut `sharelatex` kontainer memerlukan direktori untuk menyimpan data yang berkaitan dengan kompilasi LaTeX. Direktori ini diatur dengan `OVERLEAF_DATA_PATH` variabel di `config/overleaf.rc`.

Berikut `mongo` kontainer, jika diaktifkan, memerlukan direktori untuk menyimpan file basis datanya, dan hal yang sama berlaku untuk `redis` kontainer. Direktori-direktori ini juga dapat dikonfigurasi di `config/overleaf.rc`.

#### Izin File

Karena Docker berjalan sebagai `root`, direktori data pada akhirnya akan dimiliki oleh pengguna `root` user, meskipun Toolkit digunakan oleh pengguna non-root. Ini bukan masalah, tetapi patut diperhatikan jika Anda bermaksud mengubah data persisten dari luar kontainer.

### Lokasi file konfigurasi

Semua file konfigurasi milik pengguna berada di `config/` direktori.

Direktori ini **dikecualikan** dari sistem kontrol revisi git, sehingga tidak akan diubah saat kode Toolkit diperbarui. Toolkit akan **tidak** mengubah data apa pun di `config/` direktori tanpa izin Anda.

{% hint style="info" %}
Perubahan pada file konfigurasi tidak akan diterapkan secara otomatis ke kontainer yang sudah ada, meskipun kontainer dihentikan dan dimulai ulang (dengan `bin/stop` dan `bin/start`). Untuk menerapkan perubahan, jalankan `bin/up`, dan di belakang layar, `docker compose` akan secara otomatis menerapkan perubahan konfigurasi ke kontainer baru. (Atau, jalankan `bin/up -d`, jika Anda lebih suka tidak terhubung ke log Docker.)
{% endhint %}

### Berikut `overleaf.rc` file

Berikut `config/overleaf.rc` file berisi pengaturan konfigurasi tingkat atas yang paling penting yang digunakan oleh Toolkit. File ini berisi pernyataan yang menetapkan variabel, dalam format: `NAMA_VARIABEL=nilai`

Untuk melihat rincian semua opsi konfigurasi yang tersedia, lihat bagian pengaturan kami.

### Berikut `variables.env` file

Berikut `config/variables.env` file berisi variabel lingkungan yang dimuat ke dalam `sharelatex` kontainer, dan digunakan untuk mengonfigurasi microservices Overleaf. Ini mencakup nama aplikasi, seperti yang ditampilkan di header antarmuka web, pengaturan untuk mengirim email, dan pengaturan premium lainnya seperti SSO untuk digunakan dengan Server Pro.

Untuk melihat rincian semua variabel lingkungan yang tersedia, lihat [Variabel lingkungan](broken://pages/e4ca583acbab4ab521218de58b4c3788474c0454) bagian.

### Berikut `versi` file

Berikut `config/version` file berisi nomor versi citra Docker yang akan digunakan untuk membuat instans yang berjalan dari server Overleaf Anda.

{% hint style="info" %}
Perubahan pada file konfigurasi ini tidak akan diterapkan secara otomatis ke kontainer yang sudah ada, meskipun kontainer dihentikan dan dimulai ulang (dengan `bin/stop` dan `bin/start`). Untuk menerapkan perubahan Anda, jalankan `bin/up`, dan Toolkit akan secara otomatis membuat kontainer baru untuk Anda dengan perubahan konfigurasi diterapkan.
{% endhint %}

### Berikut `docker-compose.override.yml` file

Jika ada, `config/docker-compose.override.yml` file akan disertakan dalam pemanggilan `docker compose`. Ini berguna untuk menimpa konfigurasi yang khusus untuk Docker Compose.

Lihat [dokumentasi docker-compose](https://docs.docker.com/compose/extends/#adding-and-overriding-configuration) untuk detail lebih lanjut.


---

# 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/konfigurasi/overleaf-toolkit/files-and-locations.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.