> ## 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. # Variabel lingkungan Halaman ini menjelaskan variabel lingkungan yang didukung di file `config/variables.env` untuk deployment Toolkit. File `config/variables.env` terdiri dari definisi variabel dalam bentuk `NAME=value`; baris yang diawali dengan `#` diperlakukan sebagai komentar. Anda perlu membuat ulang kontainer Docker setelah mengubah apa pun di `overleaf.rc` atau `variables.env` dengan menjalankan `bin/up`. ### Semua versi Variabel lingkungan ini kompatibel dengan Server CE dan Server Pro serta menyediakan jalur migrasi yang mudah di antara kedua versi on-premise tersebut. Variabel ini juga dapat digunakan pada deployment Toolkit maupun Docker Compose. Sebelumnya, variabel lingkungan ini diawali dengan `SHARELATEX_` alih-alih `OVERLEAF_`. | Nama | Deskripsi | | - | - | | `OVERLEAF_SITE_URL` | Alamat tempat instance Overleaf Anda tersedia untuk publik. Ini digunakan dalam tautan publik dan saat terhubung melalui websocket, sehingga harus dikonfigurasi dengan benar! | | `OVERLEAF_ADMIN_EMAIL` | Alamat email yang dapat digunakan pengguna untuk menghubungi pengelola situs. | | `OVERLEAF_APP_NAME` | Nama yang ditampilkan saat merujuk ke aplikasi yang sedang berjalan. Default-nya adalah 'Overleaf (Community Edition)'. | | `OVERLEAF_MONGO_URL` dan `MONGO_URL` | URL database Mongo yang akan digunakan. | | `OVERLEAF_REDIS_HOST` dan `REDIS_HOST` | Nama host instance Redis yang akan digunakan. Keduanya wajib diatur (lihat [catatan rilis](/id/on-premises/release-notes)). | | `OVERLEAF_REDIS_PORT` dan `REDIS_PORT` | Port instance Redis yang akan digunakan. Keduanya wajib diatur (lihat [catatan rilis](/id/on-premises/release-notes)). | | `OVERLEAF_REDIS_PASS` dan `REDIS_PASSWORD` | Kata sandi yang digunakan saat terhubung ke Redis (jika ada). **Kedua** variabel lingkungan harus diatur. Lihat [mengaktifkan autentikasi kata sandi](/id/on-premises/configuration/overleaf-toolkit/redis#enabling-password-authentication) untuk informasi lebih lanjut. | | `OVERLEAF_REDIS_TLS` |

Jika diatur ke `true`, memungkinkan koneksi ke instance Redis yang memerlukan TLS.

Catatan: mTLS saat ini tidak didukung.

| | `OVERLEAF_NAV_TITLE` | Mengatur judul tab aplikasi. | | `OVERLEAF_HEADER_IMAGE_URL_LIGHT` dan `OVERLEAF_HEADER_IMAGE_URL_DARK` | URL logo header kustom untuk tema terang dan gelap (ditambahkan di 6.3.0). Setiap tema akan kembali menggunakan `OVERLEAF_HEADER_IMAGE_URL` jika variabel khususnya tidak diatur. Lihat [Branding](/id/on-premises/configuration/overleaf-toolkit/branding "mention"). | | `OVERLEAF_LINKED_URL_OUTBOUND_PROXY` | URL proxy HTTP(S) untuk mengambil file tertaut eksternal serta sumber daya ZIP atau TeX eksternal melalui API Open in Overleaf. Tersedia mulai dari rilis ulang Ayakaleaf Pro `6.3.0` (3 Oktober 2026). Biarkan tidak diatur untuk terhubung secara langsung. Contoh: `OVERLEAF_LINKED_URL_OUTBOUND_PROXY=http://proxy.internal:3128`. Lihat [Outbound Proxy](/id/on-premises/configuration/overleaf-toolkit/external-url#outbound-proxy "mention") untuk konfigurasi dan pembatasan akses jaringan. | | `OVERLEAF_INVITE_TOKEN_SECRET` |

Wajib. String acak yang digunakan untuk mengamankan token berbagi proyek (Ditambahkan di Server Pro 6.2.0).

Jumlah karakter minimum: 16

| | `OVERLEAF_SESSION_SECRET` | String acak yang digunakan untuk mengamankan token; jika menggunakan load balancing, nilai ini harus diatur ke token yang sama di semua mesin. Jika hanya satu instance yang dijalankan, pengguna tidak perlu mengaturnya. | | `OVERLEAF_COOKIE_SESSION_LENGTH` | Memungkinkan Anda mengganti waktu kedaluwarsa default cookie sesi yaitu 5 hari. Nilai pengganti harus dalam milidetik. Contoh: agar sesi berlangsung 1 jam, atur `COOKIE_SESSION_LENGTH=3600000`. (Ditambahkan di Server Pro 4.2) | | `OVERLEAF_TRUSTED_PROXY_IPS` |

Jika tidak diatur, default-nya adalah `loopback`. Jika diatur secara manual, selain IP tepercaya Anda, Anda juga harus menyertakan `loopback` (atau `127.0.0.1`), yang memercayai instance nginx yang berjalan di dalam kontainer sharelatex. Hanya alamat IP dan rentang CIDR yang diterima: jangan menambahkan nama host seperti `localhost`, karena jika tidak, Overleaf akan gagal dijalankan dan mengembalikan `502 Bad Gateway`.

Jika Anda menggunakan subnet dari `172.16.0.0/12` (subnet default untuk jaringan Docker) untuk jaringan reguler Anda, atur `OVERLEAF_TRUSTED_PROXY_IPS=loopback,` di `config/variables.env` Anda. Di sini `` adalah nilai `IPAM -> Config -> Subnet` pada `docker inspect overleaf_default`, misalnya `OVERLEAF_TRUSTED_PROXY_IPS=loopback,172.19.0.0/16`. Hal ini untuk mencegah pemalsuan header `X-Forwarded`.

Jika Anda menggunakan proxy TLS eksternal (yaitu tidak dikelola oleh Overleaf Toolkit), pastikan bahwa `OVERLEAF_TRUSTED_PROXY_IPS=loopback,`, misalnya `OVERLEAF_TRUSTED_PROXY_IPS=loopback,192.168.13.37`.

| | `OVERLEAF_RESTRICT_INVITES_TO_EXISTING_ACCOUNTS` | Jika diatur ke `true`, undangan proyek akan dibatasi hanya untuk alamat email yang sesuai dengan akun pengguna yang sudah ada. | | `OVERLEAF_ALLOW_PUBLIC_ACCESS` | Jika diatur ke `true`, pengguna yang tidak terautentikasi dapat melihat situs. Default-nya adalah `false`, yang berarti pengguna yang tidak terautentikasi akan selalu dialihkan ke halaman login ketika mencoba melihat bagian mana pun dari situs. Perlu dicatat, mengatur opsi ini sama sekali tidak menonaktifkan autentikasi atau keamanan. Opsi ini diperlukan jika pengguna Anda ingin menjadikan proyek mereka publik dan agar pengguna yang tidak terautentikasi dapat melihat proyek tersebut. | | `OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING` | Jika diatur ke `true`, pengguna anonim dapat melihat dan menyunting proyek yang dibagikan melalui fitur [berbagi tautan](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27). | | `OVERLEAF_DISABLE_LINK_SHARING` | Menonaktifkan fitur [berbagi tautan](https://www.overleaf.com/blog/integration-update-link-sharing-2017-11-27). | | `EMAIL_CONFIRMATION_DISABLED` | Jika diatur ke `true`, banner yang meminta konfirmasi email tidak akan ditampilkan. | | `ADDITIONAL_TEXT_EXTENSIONS` | Array string untuk mengonfigurasi ekstensi tambahan bagi file yang dapat disunting. | | `DEFAULT_LATEX_COMPILER` |

Digunakan untuk mengatur compiler default yang digunakan oleh proyek baru. (Ditambahkan di Server Pro 6.2.0).

Opsi: `pdflatex`, `latex`, `xelatex` atau `lualatex`

| | `OVERLEAF_STATUS_PAGE_URL` | URL halaman status kustom (Ditambahkan di Server Pro 3.4.0), misalnya `status.example.com`. | | `OVERLEAF_FPH_INITIALIZE_NEW_PROJECTS` | Atur ke `'false'` untuk mencegah proyek baru diinisialisasi dengan Full Project History (Ditambahkan di Server Pro 3.5.0). | | `OVERLEAF_FPH_DISPLAY_NEW_PROJECTS` | Atur ke `'false'` untuk mencegah proyek baru menampilkan Full Project History alih-alih riwayat lama (legacy) (Ditambahkan di Server Pro 3.5.0). | | `ENABLE_CRON_RESOURCE_DELETION` | Atur variabel lingkungan ini ke `true` untuk mengaktifkan pembersihan otomatis proyek dan pengguna yang dihapus setelah 90 hari. | | `OVERLEAF_USER_HARD_DELETION_DELAY` |

Digunakan untuk mengubah jeda kedaluwarsa pengguna yang dihapus. Dikonfigurasi dalam milidetik.

Default: 90 hari

| | `OVERLEAF_PROJECT_HARD_DELETION_DELAY` |

Digunakan untuk mengubah jeda kedaluwarsa proyek yang dihapus. Dikonfigurasi dalam milidetik.

Default: 90 hari

| | `MAX_UPLOAD_SIZE` |

Mengendalikan ukuran maksimum satu unggahan, dalam megabyte. Default-nya adalah `50`.

Perhatian: Variabel ini hanya berupa angka mentah, tanpa satuan (MB) atau pembungkus.

Total ukuran tidak terkompresi dari file `.zip` yang diunggah dibatasi hingga 6 × nilai ini (300 MB secara default).

| | `COMPILE_SIZE_LIMIT` | Mengendalikan ukuran maksimum body permintaan dalam byte. Ini adalah jumlah ukuran semua file doc dalam proyek (`main.tex`, `references.bib` (jika tidak ditautkan), dll.) yang perlu dikirim dalam permintaan kompilasi awal ke layanan CLSI. | | `COMPILE_TIMEOUT` | Jumlah waktu dalam detik yang diizinkan untuk menyelesaikan kompilasi. Untuk informasi lebih lanjut, lihat [Memperbarui batas waktu kompilasi proyek](/id/on-premises/user-and-project-management/project-management#updating-project-compile-timeout). | | `MAX_RECONNECT_GRACEFULLY_INTERVAL_MS` | Jeda yang dapat dikonfigurasi antara penyambungan ulang editor secara graceful, penyimpanan (flush) data, dan penghentian kontainer untuk mengurangi risiko kehilangan data. | | `SECCOMP_PROFILE` |

Atur variabel lingkungan ini ke path pada mesin host Docker yang menunjuk ke profil SECCOMP. Anda dapat mengunduh salinan profil tersebut di sini.

Saat ini diperlukan untuk deployment Podman saat menggunakan Sandboxed Compiles.

| | `OVERLEAF_DISABLE_CHAT` | Jika diatur ke `true`, fitur obrolan di dalam proyek akan dinonaktifkan. | | `OVERLEAF_LOGIN_SUPPORT_TEXT` | Jika diatur, dapat digunakan untuk menampilkan informasi dukungan di bawah tombol login. Teks akan ditampilkan di layar login dan dapat digunakan untuk mengarahkan pengguna ke dukungan internal atau memberikan panduan terkait login, pembuatan akun, dll. | | `ALLOW_MONGO_ADMIN_CHECK_FAILURES` |

Jika diatur ke `true`, pemeriksaan saat startup MongoDB diizinkan gagal tanpa mencegah deployment dimulai. Hal ini mungkin diperlukan jika Anda menggunakan database MongoDB di mana pengguna database Anda tidak memiliki peran `clusterParameterReader`.

Untuk bantuan membuat peran kustom, lihat di sini.

| | `V1_HISTORY_URL_FOR_GIT_BRIDGE` | Memungkinkan pemisahan endpoint **history-v1** untuk lalu lintas internal (layanan `web` → layanan `history-v1`, keduanya di dalam kontainer `sharelatex`) dan lalu lintas eksternal (`git-bridge` → `history-v1`, berjalan di kontainer terpisah). | | `OVERLEAF_MAINTENANCE_MESSAGE` dan `OVERLEAF_MAINTENANCE_MESSAGE_HTML` | Digunakan untuk menyesuaikan judul dan isi halaman Pemeliharaan. Tidak dapat digunakan bersama `OVERLEAF_STATUS_PAGE_URL`. | Pembatasan kata sandi dapat diberlakukan pada pengguna saat menggunakan sistem login Overleaf (akun lokal), bukan opsi SSO seperti LDAP. Untuk akun SSO, kebijakan kata sandi akan diberlakukan oleh penyedia identitas atau layanan direktori Anda, yang juga memungkinkan dukungan autentikasi multi-faktor. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.