Toolkit ayarları - Ayakaleaf Pro

Bu sayfa, Toolkit dağıtımlarında config/overleaf.rc dosyasında desteklenen ortam değişkenlerini açıklar. config/overleaf.rc dosyası, NAME=value biçimindeki değişken tanımlarından oluşur. # ile başlayan satırlar yorum olarak değerlendirilir.

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.

Konteyner

`sharelatex`

Ad	Açıklama
`PROJECT_NAME`	`docker-compose` komutuna verilen `--project-name` bayrağının değerini ayarlar. Her örnek farklı bir proje adına sahip olabileceğinden, tek bir ana bilgisayarda birden fazla Overleaf örneği çalıştırırken kullanışlıdır. - Varsayılan: `overleaf`
`OVERLEAF_IMAGE_NAME`	Server Pro/CE uygulama konteyneri tarafından kullanılan Docker imajı. Bu yalnızca Docker imajı adıdır; Docker imajı etiketi `config/version` dosyasından alınır. - Varsayılan: - Server Pro: `ghcr.io/ayaka-notes/overleaf-pro` - Community Edition: `sharelatex/sharelatex`
`SERVER_PRO`	`true` olarak ayarlandığında Toolkit’e varsayılan Server CE imajı (`sharelatex/sharelatex`) yerine Server Pro imajını (`ghcr.io/ayaka-notes/overleaf-pro`) kullanmasını söyler. - Varsayılan: `false`
`GIT_BRIDGE_ENABLED`	git-bridge özelliğini etkinleştirmek için `true` olarak ayarlayın (yalnızca Server Pro). Daha fazla bilgi için https://www.overleaf.com/learn/how-to/Git_integration kullanıcı belgelerine bakın. - Varsayılan: `false`
`GIT_BRIDGE_IMAGE`	git-bridge konteyneri tarafından kullanılan Docker imajı (yalnızca Server Pro). Bu yalnızca Docker imajı adıdır; Docker imajı etiketi `config/version` dosyasından alınır. - Varsayılan: `ghcr.io/ayaka-notes/overleaf-pro/git-bridge`
`GIT_BRIDGE_DATA_PATH`	`git-bridge` konteynerine (yalnızca Server Pro) bağlanacak ve git depolarını saklamak için kullanılacak dizinin yolunu ayarlar. Bu, tam bir yol (`/` ile başlayan) veya Toolkit’in temel dizinine göre göreli bir yol olabilir.
`GIT_BRIDGE_LOG_LEVEL`	`git-bridge` konteynerinin günlük düzeyini yapılandırır. Kullanılabilir düzeyler: `TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`. - Varsayılan: `INFO`
`SIBLING_CONTAINERS_ENABLED`	`true` olarak ayarlandığında Toolkit’e, projeleri her proje için ayrı bir Docker konteyneri kullanarak ayrı korumalı alanlarda derlemek için Sibling Containers tekniğini kullanmasını söyler. Daha fazla bilgi için <server-pro-only-configuration/sandboxed-compiles> belgelerine bakın. - Gerektirir: `SERVER_PRO=true` - Varsayılan: `true`
`SIBLING_CONTAINERS_PULL`	`true` olarak ayarlandığında Toolkit’e, `bin/up` komutu kullanılırken config/variables.env dosyasında `ALL_TEX_LIVE_DOCKER_IMAGES` ile ayarlanan tüm TeX Live imajlarını otomatik olarak çekmesini söyler. - Varsayılan: `true`
`DOCKER_SOCKET_PATH`	Ana makinedeki (Toolkit’i çalıştıran makine) Docker soketinin yolunu ayarlar. `SIBLING_CONTAINERS_ENABLED` değeri `true` olduğunda, derleyici hizmetinin ana bilgisayarda yeni Docker konteynerleri başlatabilmesi için soket konteynere bağlanır. - Gerektirir: `SIBLING_CONTAINERS_ENABLED=true` - Varsayılan: `/var/run/docker.sock`
`OVERLEAF_DATA_PATH`	Ana `sharelatex` konteynerine bağlanacak ve derleme verilerini saklamak için kullanılacak dizinin yolunu ayarlar. Bu, tam bir yol (`/` ile başlayan) veya Toolkit’in temel dizinine göre göreli bir yol olabilir. - Varsayılan: `data/overleaf`
`OVERLEAF_LISTEN_IP`	Konteynerin bağlanacağı ana bilgisayar IP adresini/adreslerini ayarlar. Örneğin bu değer `0.0.0.0` olarak ayarlanırsa web arayüzü herhangi bir ana bilgisayar IP adresinde kullanılabilir olur. Konteynere doğrudan erişim için `OVERLEAF_LISTEN_IP` değeri genel IP adresinize ayarlanmalıdır. `OVERLEAF_LISTEN_IP` değerini `0.0.0.0` ya da ana bilgisayarınızın harici IP adresi olarak ayarlamak, ile birlikte kullanıldığında genellikle hatalara neden olur. - Varsayılan: `127.0.0.1`
`OVERLEAF_PORT`	Konteynerin bağlanacağı ana bilgisayar bağlantı noktasını ayarlar. Örneğin bu değer `8099` ve `OVERLEAF_LISTEN_IP` değeri `127.0.0.1` olarak ayarlanırsa web arayüzü `http://localhost:8099` adresinde kullanılabilir olur. - Varsayılan: `80`
`OVERLEAF_LOG_PATH`	Ana `sharelatex` konteynerine bağlanacak ve uygulama günlüklerini Docker ana bilgisayarında erişilebilir kılmak için kullanılacak dizinin yolunu ayarlar. Bu, tam bir yol (`/` ile başlayan) veya Toolkit’in temel dizinine göre göreli bir yol olabilir. Bind-mount’u devre dışı bırakmak için yapılandırma girdisini kaldırın. Ayarlanmadığında, konteyner yeniden oluşturulurken günlükler atılır. Günlük kaydı hakkında bilgi için bkz. - Varsayılan: ayarlanmamış

`mongo`

Ad	Açıklama
`MONGO_ENABLED`	`true` olarak ayarlandığında Toolkit’e veritabanını barındırmak için bir MongoDB konteyneri oluşturmasını söyler. `false` olarak ayarlandığında bu konteyner oluşturulmaz ve sistem bunun yerine `MONGO_URL` ile belirtilen MongoDB veritabanını kullanır. - Varsayılan: `true`
`MONGO_URL`	`MONGO_ENABLED` değeri `false` olduğunda kullanılacak MongoDB bağlantı URL’sini belirtir. - Varsayılan: ayarlanmamış
`MONGO_DATA_PATH`	`mongo` konteynerine bağlanacak ve MongoDB veritabanını saklamak için kullanılacak dizinin yolunu ayarlar. Bu, tam bir yol (`/` ile başlayan) veya toolkit’in temel dizinine göre göreli bir yol olabilir. Bu seçenek yalnızca `MONGO_ENABLED` değeri `true` olduğunda oluşturulan yerel `mongo` konteynerini etkiler. - Varsayılan: `data/mongo`
`MONGO_IMAGE`	MongoDB konteyneri tarafından kullanılan Docker imajı. Bu yalnızca Docker imajının adıdır; Docker imajı etiketi `MONGO_VERSION` değişkenine yazılmalıdır (aşağıya bakın). - Varsayılan: `mongo`
`MONGO_VERSION`	MongoDB konteyneri tarafından kullanılan MongoDB sürümü. Değer, ana MongoDB sürümü ve bir nokta ile başlamalıdır, ör. `6.0` veya `6.0-with-suffix`. - Varsayılan: `6.0`

`redis`

Ad	Açıklama
`REDIS_ENABLED`	`true` olarak ayarlandığında Toolkit’e redis veritabanını barındırmak için bir Redis konteyneri oluşturmasını söyler. `false` olarak ayarlandığında bu konteyner oluşturulmaz ve sistem bunun yerine `REDIS_HOST` ve `REDIS_PORT` ile belirtilen Redis veritabanını kullanır. - Varsayılan: `true`
`REDIS_HOST`	`REDIS_ENABLED` değeri `false` olduğunda kullanılacak Redis ana bilgisayarını belirtir. - Varsayılan: ayarlanmamış
`REDIS_PORT`	`REDIS_ENABLED` değeri `false` olduğunda kullanılacak Redis bağlantı noktasını belirtir. - Varsayılan: ayarlanmamış
`REDIS_DATA_PATH`	`redis` konteynerine bağlanacak ve Redis veritabanını saklamak için kullanılacak dizinin yolunu ayarlar. Bu, tam bir yol (`/` ile başlayan) veya Toolkit’in temel dizinine göre göreli bir yol olabilir. Bu seçenek yalnızca `REDIS_ENABLED` değeri `true` olduğunda oluşturulan yerel `redis` konteynerini etkiler. - Varsayılan: `data/redis`
`REDIS_AOF_PERSISTENCE`	Redis için AOF (Append Only File) kalıcılığını açar. Bu, Redis kalıcılığı için önerilen yapılandırmadır. Ek ayrıntılar için <../../maintenance/data-and-backups> içindeki <../../../maintenance/data-and-backups#aof-append-only-file> bölümüne bakın. - Varsayılan: `true`

`nginx`

Ad	Açıklama
`NGINX_ENABLED`	`true` olarak ayarlandığında Toolkit’e TLS Proxy görevi görecek bir NGINX konteyneri oluşturmasını söyler. - Varsayılan: `false`
`NGINX_CONFIG_PATH`	TLS Proxy için kullanılacak NGINX yapılandırma dosyasının yolu. - Varsayılan: `config/nginx/nginx.conf`
`NGINX_TLS_LISTEN_IP`	TLS Proxy konteynerinin HTTPS için bağlanacağı ana bilgisayar IP adresini/adreslerini ayarlar. Örneğin bu değer `0.0.0.0` olarak ayarlanırsa HTTPS web arayüzü herhangi bir ana bilgisayar IP adresinde kullanılabilir olur. Genellikle bu değer ana bilgisayarınızın harici IP adresine ayarlanmalıdır. - Varsayılan: `127.0.1.1`
`NGINX_HTTP_LISTEN_IP`	TLS Proxy konteynerinin HTTP yönlendirmesi için bağlanacağı ana bilgisayar IP adresini/adreslerini ayarlar. Örneğin bu değer `127.0.1.1` olarak ayarlanırsa `127.0.1.1` adresine yapılan HTTP bağlantıları HTTPS web arayüzüne yönlendirilir. Genellikle bu değer ana bilgisayarınızın harici IP adresine ayarlanmalıdır. Genellikle `OVERLEAF_LISTEN_IP` ile çakışmaya neden olacağından `0.0.0.0` olarak ayarlamayın. - Varsayılan: `127.0.1.1`
`NGINX_HTTP_PORT`	TLS Proxy konteynerinin HTTP için bağlanacağı ana bilgisayar bağlantı noktasını ayarlar. - Varsayılan: `80`
`TLS_PORT`	TLS Proxy konteynerinin HTTPS için bağlanacağı ana bilgisayar bağlantı noktasını ayarlar. - Varsayılan: `443`
`TLS_PRIVATE_KEY_PATH`	TLS Proxy için kullanılacak özel anahtarın yolu. - Varsayılan: `config/nginx/certs/overleaf_key.pem`
`TLS_CERTIFICATE_PATH`	TLS Proxy için kullanılacak genel sertifikanın yolu. - Varsayılan: `config/nginx/certs/overleaf_certificate.pem`

Son değiştirilme tarihi 5 Ekim 2026