> ## 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. # 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: ```bash title="config/overleaf.rc" theme={null} 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://:` | | 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](https://ayakaleaf-pro.mintlify.site/tr/on-premises/configuration/overleaf-toolkit/tls-proxy.md) arkasında | `127.0.0.1` | `80` | `https://` | 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. > [!WARNING] > > 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](https://ayakaleaf-pro.mintlify.site/tr/on-premises/configuration/overleaf-toolkit/tls-proxy.md). 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. | `no-reply@lilliput.com` | | `OVERLEAF_ADMIN_EMAIL` | Kullanıcıların siteyi yöneten kişiye ulaşabileceği e-posta adresi. | `it-services@lilliput.com` | `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](https://ayakaleaf-pro.mintlify.site/tr/on-premises/configuration/overleaf-toolkit/authentication/public-access.md) 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](https://ayakaleaf-pro.mintlify.site/tr/on-premises/configuration/overleaf-toolkit/environment-variables.md) 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](https://ayakaleaf-pro.mintlify.site/tr/on-premises/configuration/overleaf-toolkit/sandboxed-compiles.md "mention") için yapılandırın. `config/variables.env` dosyasını açın ve aşağıdaki ortam değişkenlerini güncelleyin: ```dotenv title="config/variables.env" wrap theme={null} 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: ```text title="Start the instance" theme={null} 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: ```text title="Start without attaching to logs" theme={null} bin/start ``` > [!NOTE] > > 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/](http://127.0.0.1/) veya [http://localhost/](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://:8080`. Web arayüzünün hangi adres ve portta yayınlandığını kontrol etmek için şunu çalıştırın: ```text title="Show the published port" theme={null} 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. > [!WARNING] > > 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](https://ayakaleaf-pro.mintlify.site/tr/on-premises/configuration/overleaf-toolkit/toolkit-settings.md "mention") This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.