5. Örneğinizi kişiselleştirme

​

Örneğinizi kişiselleştirme

Overleaf örneğinizi ilk kez başlatmadan önce, iki yapılandırma dosyasını kendi bilgilerinizle güncelleyin:

Dosya	Okuyan	Burada ayarlananlar
config/overleaf.rc	bin/up gibi Toolkit betikleri	konteynerlerin nasıl çalışacağı: OVERLEAF_LISTEN_IP, OVERLEAF_PORT, SERVER_PRO, veri yolları
config/variables.env	konteynerin içindeki uygulama	Overleaf’in nasıl davranacağı: OVERLEAF_SITE_URL, e-posta, TeX Live imajları

1. Değişkenler dosyasını düzenleyin

   config/variables.env dosyasını sevdiğiniz metin düzenleyicide açın ve aşağıdaki ortam değişkenlerini gerekli değerlerle güncelleyin.

2. Dinleme adresi ve bağlantı noktası

   Varsayılan olarak Toolkit, web arayüzünü 127.0.0.1:80 üzerinde yayınlar; bu nedenle yalnızca sunucunun kendisindeki bir tarayıcıdan açılabilir. Diğer bilgisayarlar “connection refused” veya “server not found” hatası alır. Bunu değiştirmek için config/overleaf.rc dosyasını düzenleyin:

   config/overleaf.rc

   OVERLEAF_LISTEN_IP=0.0.0.0
   OVERLEAF_PORT=8080
   

   OVERLEAF_LISTEN_IP, konteynerin bağlandığı ana makine IP adresidir; OVERLEAF_PORT ise ana makine bağlantı noktasıdır. Birlikte OVERLEAF_LISTEN_IP:OVERLEAF_PORT:80 Docker port eşlemesini oluştururlar. Kurulumunuza uyan değerleri seçin:

   Kurulum	OVERLEAF_LISTEN_IP	OVERLEAF_PORT	Tarayıcıda açın
   Yalnızca bu makinede (varsayılan)	127.0.0.1	80	http://localhost
   LAN’daki veya internetteki diğer bilgisayarlar doğrudan bağlanır	0.0.0.0 veya sunucunun bir IP’si	80 veya herhangi bir boş port	http://<server-ip>:<port>
   Aynı ana makinede kendi reverse proxy’nizin (NGINX, Caddy, Cloudflare Tunnel) arkasında	127.0.0.1	herhangi bir boş port	proxy’nin URL’si
   Toolkit TLS proxy arkasında	127.0.0.1	80	https://<your-domain>

   Ana makinede 80 numaralı port zaten kullanılıyorsa (örneğin başka bir web sunucusu tarafından), OVERLEAF_PORT değerini 8080 gibi boş bir porta ayarlayın. Aksi takdirde bin/up, bind: address already in use hatasıyla başarısız olur.

   Docker tarafından yayınlanan portlar ufw ve firewalld gibi ana makine güvenlik duvarlarını atlar. 0.0.0.0 ile örneğe, sunucunun bağlı olduğu her ağdan erişilebilir. Bir bulut sunucusunda ayrıca sağlayıcının güvenlik grubunda porta izin vermeniz gerekir. Örneği internete açmadan önce HTTPS kullanın; bkz. TLS proxy.

   Varsayılanla başlayıp örneği önce localhost üzerinde açabilirsiniz. Daha sonra diğer bilgisayarlardan erişime izin vermek için config/overleaf.rc içindeki bu iki değişkeni ve config/variables.env içindeki OVERLEAF_SITE_URL değerini değiştirin, ardından konteynerleri yeniden oluşturmak için bin/up komutunu tekrar çalıştırın.

3. Gerekli ortam değişkenleri

   config/variables.env içindeki aşağıdaki değişkenleri güncelleyin:

   Ad	Açıklama	Örnek
   OVERLEAF_SITE_URL	Overleaf örneğinizin herkese açık olarak erişilebildiği adres. Bu adres herkese açık bağlantılarda ve websocket üzerinden bağlanırken kullanılır, bu yüzden doğru şekilde yapılandırılmalıdır!	https://overleaf.lilliput.com
   OVERLEAF_EMAIL_FROM_ADDRESS	Bu e-posta adresi, giden tüm e-postalar için from adresi olarak kullanılır.	[e-mail]
   OVERLEAF_ADMIN_EMAIL	Kullanıcıların siteyi yöneten kişiye ulaşabileceği e-posta adresi.	[e-mail]

   OVERLEAF_SITE_URL, dinleme adresi değil, kullanıcıların tarayıcılarına yazdığı adrestir. Port 80 (HTTP) veya 443 (HTTPS) değilse portu ekleyin, örneğin http://192.168.1.20:8080. http://0.0.0.0 kullanmayın. OVERLEAF_SITE_URL tarayıcıdaki adresle eşleşmezse düzenleyici bağlanamaz ve e-postalardaki bağlantılar ile OAuth geri çağırmaları yanlış yeri gösterir.

   Bir posta sunucunuz yoksa OVERLEAF_EMAIL_FROM_ADDRESS değerini ayarlamadan bırakın: Overleaf bu durumda e-posta göndermez ve yeni kullanıcılara etkinleştirme bağlantılarını kendiniz iletebilirsiniz; bkz. Herkese Açık Erişim sayfasındaki Soru&Cevap bölümü.

   Ayrıca OVERLEAF_SESSION_SECRET değerini openssl rand -hex 32 ile üretilmiş bir değere ayarlayın. Bu değer olmadan, konteyneri yeniden oluşturan her bin/up ve her yükseltme tüm kullanıcıların oturumunu kapatır. Bkz. Ortam Değişkenleri sayfasındaki Soru&Cevap bölümü.

   Bu ortam değişkenlerini güncelledikten sonra kaydedip çıkın.

4. Sandbox Compile kurulumu

   Ardından, TeX Live Full’u sandboxed-compiles.md için yapılandırın. config/variables.env dosyasını açın ve aşağıdaki ortam değişkenlerini güncelleyin:

   config/variables.env

   ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1, ghcr.io/ayaka-notes/texlive-full:2025.1
   ALL_TEX_LIVE_DOCKER_IMAGE_NAMES=Texlive 2026, Texlive 2025
   TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
   
5. Örneğinizi başlatın

   Örneğinizi başlatmak için şunu çalıştırın:

   Start the instance

   bin/up
   

   Bu komut, texlive dahil gerekli imajları indirir, konteynerleri (özelleştirmelerinizi kullanarak) oluşturur ve örneği başlatır. Çeşitli Docker konteynerlerinden gelen günlük çıktısını görmelisiniz.

   Daha sonra bunları (günlük çıktısına bağlanmadan) yeniden başlatmak için şunu çalıştırın:

   Start without attaching to logs

   bin/start
   

Toolkit, Overleaf Docker konteynerlerini yönetmek için docker compose kullanır. Toolkit, docker compose’u sarmalayan ve ayrıntıların çoğunu sizin yerinize halleden bir dizi betik sağlar.

Her şey yolunda giderse, tarayıcınızda http://127.0.0.1/ veya http://localhost/ adresine giderek yeni Overleaf örneğinizin giriş sayfasını görebilmeniz gerekir. OVERLEAF_LISTEN_IP veya OVERLEAF_PORT değerini değiştirdiyseniz, bunun yerine Dinleme adresi ve bağlantı noktası adımındaki tablodan ilgili adresi açın, örneğin http://<server-ip>:8080.

Web arayüzünün hangi adres ve portta yayınlandığını kontrol etmek için şunu çalıştırın:

Show the published port

bin/docker-compose port sharelatex 80

Çıktı, örneğin 0.0.0.0:8080, kullanılan ana makine IP adresini ve portunu gösterir. 127.0.0.1 gösteriyorsa örneğe yalnızca sunucunun kendisinden erişilebilir.

Ağ yapılandırmanıza ve Overleaf örneğinizin nerede barındırıldığına bağlı olarak ek yapılandırma değişiklikleri yapmanız gerekebilir. Daha fazla ayrıntı için Toolkit ayarlarına bakın: toolkit-settings.md