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).
OVERLEAF_REDIS_PORT dan REDIS_PORT	Port instance Redis yang akan digunakan. Keduanya wajib diatur (lihat catatan rilis).
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 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.
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 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,<network> di config/variables.env Anda. Di sini <network> 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,<ip-of-your-tls-proxy>, 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.
OVERLEAF_DISABLE_LINK_SHARING	Menonaktifkan fitur berbagi tautan.
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.
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.