Ortam değişkenleri

Bu sayfa, Toolkit dağıtımları için config/variables.env dosyasında desteklenen ortam değişkenlerini açıklar.

config/variables.env dosyası NAME=value biçimindeki değişken tanımlarından oluşur; # ile başlayan satırlar yorum olarak kabul edilir.

overleaf.rc veya variables.env dosyasında herhangi bir değişiklik yaptıktan sonra bin/up komutunu çalıştırarak Docker konteynerlerini yeniden oluşturmanız gerekir.

​

Tüm sürümler

Bu ortam değişkenleri Server CE ve Server Pro ile uyumludur ve bu iki şirket içi sürüm arasında kolay bir geçiş yolu sağlar. Hem Toolkit hem de Docker Compose dağıtımlarında kullanılabilirler.

Bu ortam değişkenleri önceden OVERLEAF_ yerine SHARELATEX_ önekiyle başlıyordu.

Ad	Açıklama
OVERLEAF_SITE_URL	Overleaf örneğinizin herkese açık olarak erişilebildiği adres. Bu değer herkese açık bağlantılarda ve websocket üzerinden bağlanırken kullanılır, bu nedenle doğru yapılandırılmalıdır!
OVERLEAF_ADMIN_EMAIL	Kullanıcıların siteyi yöneten kişiye ulaşabileceği e-posta adresi.
OVERLEAF_APP_NAME	Çalışan uygulamadan söz edilirken gösterilecek ad. Varsayılan değer ‘Overleaf (Community Edition)’.
OVERLEAF_MONGO_URL ve MONGO_URL	Kullanılacak Mongo veritabanının URL’si.
OVERLEAF_REDIS_HOST ve REDIS_HOST	Kullanılacak Redis örneğinin ana makine adı. Her ikisi de gereklidir (bkz. sürüm notları).
OVERLEAF_REDIS_PORT ve REDIS_PORT	Kullanılacak Redis örneğinin bağlantı noktası. Her ikisi de gereklidir (bkz. sürüm notları).
OVERLEAF_REDIS_PASS ve REDIS_PASSWORD	Redis’e bağlanırken kullanılacak parola (varsa). Her iki ortam değişkeninin de ayarlanması gerekir. Daha fazla bilgi için parola kimlik doğrulamasını etkinleştirme bölümüne bakın.
OVERLEAF_REDIS_TLS	true olarak ayarlanırsa TLS gerektiren bir Redis örneğine bağlanmaya izin verir. Not: mTLS şu anda desteklenmemektedir.
OVERLEAF_NAV_TITLE	Uygulamanın sekme başlığını ayarlar.
OVERLEAF_HEADER_IMAGE_URL_LIGHT ve OVERLEAF_HEADER_IMAGE_URL_DARK	Açık ve koyu temalar için özel başlık logolarının URL’leri (6.3.0’da eklendi). Kendisine özgü değişken ayarlanmadığında her tema OVERLEAF_HEADER_IMAGE_URL değerine geri döner. Bkz. Markalama.
OVERLEAF_LINKED_URL_OUTBOUND_PROXY	Harici bağlantılı dosyaları ve Open in Overleaf API aracılığıyla harici ZIP veya TeX kaynaklarını getirmek için kullanılan HTTP(S) proxy’sinin URL’si. Yeniden yayımlanan Ayakaleaf Pro 6.3.0 (3 Ekim 2026) sürümünden itibaren kullanılabilir. Doğrudan bağlanmak için ayarlamadan bırakın. Örnek: OVERLEAF_LINKED_URL_OUTBOUND_PROXY=http://proxy.internal:3128. Yapılandırma ve ağ erişimi kısıtlamaları için Giden Proxy bölümüne bakın.
OVERLEAF_INVITE_TOKEN_SECRET	Zorunlu. Proje paylaşım token’larını güvence altına almak için kullanılan rastgele bir dize (Server Pro 6.2.0’da eklendi). En az karakter sayısı: 16
OVERLEAF_SESSION_SECRET	Token’ları güvence altına almak için kullanılan rastgele bir dize; yük dengeleme yapılıyorsa tüm makinelerde aynı değere ayarlanmalıdır. Yalnızca 1 örnek çalıştırılıyorsa kullanıcı tarafından ayarlanması gerekmez.
OVERLEAF_COOKIE_SESSION_LENGTH	Varsayılan 5 günlük oturum çerezi sona erme süresini geçersiz kılmanızı sağlar. Geçersiz kılma değeri milisaniye cinsinden olmalıdır. Örnek: oturumun 1 saat sürmesi için COOKIE_SESSION_LENGTH=3600000 ayarlayın. (Server Pro 4.2’de eklendi)
OVERLEAF_TRUSTED_PROXY_IPS	Ayarlanmazsa varsayılan değer loopback olur. Elle ayarlıyorsanız, güvenilir IP’lerinize ek olarak sharelatex konteyneri içinde çalışan nginx örneğine güvenen loopback (veya 127.0.0.1) değerini de eklemeniz gerekir. Yalnızca IP adresleri ve CIDR aralıkları kabul edilir: localhost gibi ana makine adları eklemeyin, aksi takdirde Overleaf başlatılamaz ve 502 Bad Gateway döndürür. Normal ağınız için 172.16.0.0/12 (Docker ağları için varsayılan alt ağ) aralığından bir alt ağ kullanıyorsanız, lütfen config/variables.env dosyanızda OVERLEAF_TRUSTED_PROXY_IPS=loopback,<network> ayarlayın. Burada <network>, docker inspect overleaf_default çıktısındaki IPAM -> Config -> Subnet değeridir, ör. OVERLEAF_TRUSTED_PROXY_IPS=loopback,172.19.0.0/16. Bu, X-Forwarded başlıklarının sahteciliğini önlemek içindir. Harici bir TLS proxy’si (yani Overleaf Toolkit tarafından yönetilmeyen) kullanıyorsanız, lütfen OVERLEAF_TRUSTED_PROXY_IPS=loopback,<ip-of-your-tls-proxy> olduğundan emin olun, ör. OVERLEAF_TRUSTED_PROXY_IPS=loopback,192.168.13.37.
OVERLEAF_RESTRICT_INVITES_TO_EXISTING_ACCOUNTS	true olarak ayarlanırsa proje davetlerini mevcut kullanıcı hesaplarına karşılık gelen e-posta adresleriyle sınırlar.
OVERLEAF_ALLOW_PUBLIC_ACCESS	true olarak ayarlanırsa kimliği doğrulanmamış kullanıcıların siteyi görüntülemesine izin verir. Varsayılan değer false’tur; bu, kimliği doğrulanmamış kullanıcıların sitenin herhangi bir bölümünü görüntülemeye çalıştıklarında koşulsuz olarak giriş sayfasına yönlendirileceği anlamına gelir. Bu seçeneği ayarlamanın kimlik doğrulamayı veya güvenliği hiçbir şekilde devre dışı bırakmadığını unutmayın. Kullanıcılarınız projelerini herkese açık yapmayı ve kimliği doğrulanmamış kullanıcıların bu projeleri görüntülemesini istiyorsa bu seçenek gereklidir.
OVERLEAF_ALLOW_ANONYMOUS_READ_AND_WRITE_SHARING	true olarak ayarlanırsa anonim kullanıcıların bağlantıyla paylaşım özelliği aracılığıyla paylaşılan projeleri görüntülemesine ve düzenlemesine izin verir.
OVERLEAF_DISABLE_LINK_SHARING	Bağlantıyla paylaşım özelliğini devre dışı bırakır.
EMAIL_CONFIRMATION_DISABLED	true olarak ayarlandığında e-posta onayı isteyen başlık bandı gösterilmez.
ADDITIONAL_TEXT_EXTENSIONS	Düzenlenebilir dosyalar için ek uzantıları yapılandıran bir dize dizisi.
DEFAULT_LATEX_COMPILER	Yeni projeler tarafından kullanılan varsayılan derleyiciyi ayarlamak için kullanılır. (Server Pro 6.2.0’da eklendi). Seçenekler: pdflatex, latex, xelatex veya lualatex
OVERLEAF_STATUS_PAGE_URL	Özel durum sayfası URL’si (Server Pro 3.4.0’da eklendi), ör. status.example.com.
OVERLEAF_FPH_INITIALIZE_NEW_PROJECTS	Yeni projelerin Tam Proje Geçmişi (Full Project History) ile başlatılmasını önlemek için 'false' olarak ayarlayın (Server Pro 3.5.0’da eklendi).
OVERLEAF_FPH_DISPLAY_NEW_PROJECTS	Yeni projelerin eski geçmiş yerine Tam Proje Geçmişi’ni göstermesini önlemek için 'false' olarak ayarlayın (Server Pro 3.5.0’da eklendi).
ENABLE_CRON_RESOURCE_DELETION	Silinen projelerin ve kullanıcıların 90 gün sonra otomatik olarak temizlenmesini etkinleştirmek için bu ortam değişkenini true olarak ayarlayın.
OVERLEAF_USER_HARD_DELETION_DELAY	Silinen kullanıcıların sona erme gecikmesini değiştirmek için kullanılır. Milisaniye cinsinden yapılandırılır. Varsayılan: 90 gün
OVERLEAF_PROJECT_HARD_DELETION_DELAY	Silinen projelerin sona erme gecikmesini değiştirmek için kullanılır. Milisaniye cinsinden yapılandırılır. Varsayılan: 90 gün
MAX_UPLOAD_SIZE	Tek bir yüklemenin megabayt cinsinden en büyük boyutunu kontrol eder. Varsayılan değer 50. Dikkat: Bu değişken birim (MB) veya sarmalayıcı içermeyen yalın bir sayıdır. Yüklenen bir .zip dosyasının sıkıştırılmamış toplam boyutu bu değerin 6 katıyla sınırlıdır (varsayılan olarak 300 MB).
COMPILE_SIZE_LIMIT	Bayt cinsinden en büyük istek gövdesi boyutunu kontrol eder. Bu, CLSI servisine gönderilen ilk derleme isteğinde gönderilmesi gereken, proje içindeki tüm belge dosyası boyutlarının (main.tex, references.bib (bağlantılı değilse) vb.) toplamıdır.
COMPILE_TIMEOUT	Bir derlemenin tamamlanması için izin verilen saniye cinsinden süre. Daha fazla bilgi için Proje derleme zaman aşımını güncelleme bölümüne bakın.
MAX_RECONNECT_GRACEFULLY_INTERVAL_MS	Veri kaybı riskini azaltmak için editörün düzgün biçimde yeniden bağlanması, verilerin kaydedilmesi (flush) ve konteynerin kapatılması arasındaki yapılandırılabilir gecikme.
SECCOMP_PROFILE	Bu ortam değişkenini, Docker ana makinesinde SECCOMP profilini gösteren bir yola ayarlayın. Profilin bir kopyasını buradan indirebilirsiniz. Şu anda Sandboxed Compiles kullanılırken Podman dağıtımları için gereklidir.
OVERLEAF_DISABLE_CHAT	true olarak ayarlanırsa proje içi sohbet özelliğini devre dışı bırakır.
OVERLEAF_LOGIN_SUPPORT_TEXT	Ayarlandığında, giriş düğmesinin altında destek bilgilerini göstermek için kullanılabilir. Metin giriş ekranında gösterilir ve kullanıcıları dahili desteğe yönlendirmek veya oturum açma, hesap oluşturma vb. ile ilgili rehberlik sağlamak için kullanılabilir.
ALLOW_MONGO_ADMIN_CHECK_FAILURES	true olarak ayarlanırsa MongoDB başlangıç kontrollerinin başarısız olmasına ve bunun dağıtımın başlamasını engellememesine izin verir. Veritabanı kullanıcınızın clusterParameterReader rolüne sahip olmadığı bir MongoDB veritabanı kullanıyorsanız bu gerekebilir. Özel bir rol oluşturma konusunda yardım için buraya bakın.
V1_HISTORY_URL_FOR_GIT_BRIDGE	history-v1 uç noktasını dahili trafik (web servisi → history-v1 servisi, her ikisi de sharelatex konteynerinde) ve harici trafik (git-bridge → history-v1, ayrı konteynerlerde çalışır) için ayırmaya olanak tanır.
OVERLEAF_MAINTENANCE_MESSAGE ve OVERLEAF_MAINTENANCE_MESSAGE_HTML	Bakım sayfasının başlığını ve içeriğini özelleştirmek için kullanılır. OVERLEAF_STATUS_PAGE_URL ile birlikte kullanılamaz.

LDAP gibi bir SSO seçeneği yerine Overleaf oturum açma sistemi (yerel hesaplar) kullanılırken kullanıcılara parola kısıtlamaları uygulamak mümkündür. SSO hesapları için parola politikaları kimlik sağlayıcınız veya dizin servisiniz tarafından uygulanır; bu da ek olarak çok faktörlü kimlik doğrulama desteğine olanak tanır.