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

# Berkas dan lokasi

Halaman ini menjelaskan file konfigurasi yang digunakan oleh Toolkit untuk mengonfigurasi penerapan 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. Hal ini dilakukan dengan memasang beberapa direktori dari mesin host ke dalam container Docker, dan menulis data ke direktori-direktori tersebut.

#### Direktori Data

Bagian `sharelatex` container memerlukan sebuah direktori tempat menyimpan data yang berkaitan dengan kompilasi LaTeX. Direktori ini diatur dengan `OVERLEAF_DATA_PATH` variabel di dalam `config/overleaf.rc`.

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

#### Izin File

Karena Docker berjalan sebagai `root`, direktori data akan menjadi milik `root` pengguna, bahkan jika Toolkit digunakan oleh pengguna non-root. Ini bukan masalah, tetapi perlu disadari jika Anda berniat mengubah data persisten dari luar container.

### Lokasi file konfigurasi

Semua file konfigurasi milik pengguna dapat ditemukan di direktori `config/` .

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

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

### Bagian `overleaf.rc` file

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

### Bagian `variables.env` file

Bagian `config/variables.env` file berisi variabel lingkungan yang dimuat ke dalam `sharelatex` container, dan digunakan untuk mengonfigurasi layanan mikro 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.

### Bagian `versi` file

Bagian `config/version` file berisi nomor versi image Docker yang akan digunakan untuk membuat instance aktif server Overleaf Anda.

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

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

Jika ada, `config/docker-compose.override.yml` file akan disertakan dalam pemanggilan ke `docker compose`. Ini berguna untuk menimpa konfigurasi khusus 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://ayakaleaf-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.