> ## 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.

# 2. Toolkit'i tanıyın

### Etrafa bir göz atma

Artık Toolkit'in yerel bir kopyasına sahip olduğunuza göre, `ls` komutunu kullanarak deponun yapısına bir göz atalım.

```bash title="Run this" theme={null}
ls -l
```

> [!NOTE]
>
> `ls -l` komutu, bir dizinin içeriğini ayrıntılı uzun liste görünümünde gösterir ve izinler, sahiplik ve boyut gibi ek dosya bilgileri sağlar.

Her şey başarıyla klonlandıysa şuna benzer bir çıktı görmelisiniz:

```text theme={null}
drwxr-xr-x 3 fry fry  4096 Aug 30 14:16 bin
-rw-r--r-- 1 fry fry  6465 Aug 30 14:16 CHANGELOG.md
drwxr-xr-x 2 fry fry  4096 Sep  6 12:43 config
drwxr-xr-x 5 fry fry  4096 Aug 30 14:22 data
drwxr-xr-x 3 fry fry  4096 Aug 30 14:16 doc
drwxr-xr-x 3 fry fry  4096 Aug 30 14:16 lib
-rw-r--r-- 1 fry fry 34520 Aug 30 14:16 LICENSE
-rw-r--r-- 1 fry fry  1178 Aug 30 14:16 README.md
```

> [!NOTE]
>
> Kullanıcıya ait tüm yapılandırma dosyaları `config/` dizininde bulunur. Bu dizin git sürüm kontrol sisteminden **hariç tutulmuştur**, bu nedenle Toolkit güncellendiğinde değiştirilmez.

## Depo düzeni

| Ad | Açıklama |
| - | - |
| `bin` | Bu klasör, Overleaf sunucu örneğinizi yönetmenize yardımcı olan bir dizi betik içerir. Bu betikler hakkında daha fazla bilgiyi aşağıdaki Komutlar bölümümüzde okuyabilirsiniz. |
| `config` | Bu klasör kendi yerel yapılandırma dosyalarınızı içerir. |
| `lib` | Bu klasör, Toolkit tarafından kullanılan temel yapılandırma dosyalarını içerir. |
| `data` | Varsayılan olarak bu klasör MongoDb, Redis ve Overleaf için depolama konumunu içerir. Daha fazla bilgi için aşağıdaki [Kalıcı veriler](https://ayakaleaf-pro.mintlify.site/tr/on-premises/configuration/overleaf-toolkit/files-and-locations.md#persistent-data) bölümüne bakın. |

> [!WARNING]
>
> `/config` klasörü dışındaki dosyaları doğrudan **değiştirmemenizi** öneririz. Bunun yerine, değişiklik yapmanız gerekiyorsa bunlar **config/variables.env** veya **config/overleaf.rc** dosyalarında ayarlanan ortam değişkenleri aracılığıyla yapılabilir.\
> Örneğin, `mongo` hizmet imajını ayarlamak için `lib/docker-compose.mongo.yml` dosyasını doğrudan düzenlemek yerine, imajı `config/overleaf.rc` içindeki `MONGO_IMAGE` ortam değişkeniyle ayarlayın. Daha fazla bilgi için [Toolkit ayarları](https://ayakaleaf-pro.mintlify.site/tr/on-premises/configuration/overleaf-toolkit/toolkit-settings.md) sayfasına bakın.

> [!NOTE]
>
> Toolkit, izniniz olmadan `config/` dizinindeki hiçbir veriyi **değiştirmez**.

## Komutlar

Bu betikleri Toolkit dizininden çalıştırın. Her biri seçeneklerini `--help` ile gösterir.

| Komut | Ne yapar |
| - | - |
| `bin/init` | `config/` içindeki yapılandırma dosyalarını ilk kez oluşturur. `bin/init --tls`, NGINX TLS proxy yapılandırmasını ekler. |
| `bin/up` | Konteynerleri oluşturur ve başlatır (`bin/docker-compose up`). Günlükleri izlemek yerine arka planda çalıştırmak için `-d` ekleyin. `config/` içindeki her değişiklikten sonra çalıştırın: yapılandırması değişen konteynerleri yeniden oluşturur. |
| `bin/start` | Mevcut konteynerleri yeniden başlatır (`bin/docker-compose start`). Yapılandırma değişikliklerini uygulamaz. |
| `bin/stop` | Konteynerleri durdurur ve korur (`bin/docker-compose stop`). |
| `bin/docker-compose` | `docker compose` komutunu Toolkit dosyalarıyla çalıştırır, örneğin `bin/docker-compose ps` veya `bin/docker-compose restart sharelatex`. |
| `bin/logs` | Bir veya daha fazla hizmetin günlüklerini gösterir veya izler, örneğin `bin/logs -f web`. |
| `bin/error-logs` | `bin/logs` gibidir, ancak yalnızca hataları gösterir. |
| `bin/shell` | `sharelatex` konteyneri içinde bir kabuk açar. |
| `bin/mongo` | `sharelatex` veritabanında bir MongoDB kabuğu açar. |
| `bin/run-script` | `sharelatex` konteynerinin içinde gelen bir betiği çalıştırır. |
| `bin/doctor` | Ana makineyi ve yapılandırmayı denetler ve yardım isterken paylaşmak için bir rapor yazdırır. |
| `bin/images` | Ana makinedeki Overleaf Docker imajlarını listeler. |
| `bin/backup-config` | `config/` dizinini bir yedekleme konumuna kopyalar (copy, zip veya tar). |
| `bin/upgrade` | Toolkit'i ve Overleaf imajını adım adım günceller; bkz. [Dağıtımınızı yükseltme](https://ayakaleaf-pro.mintlify.site/tr/on-premises/maintenance/upgrading-your-deployment.md). |
| `bin/rename-env-vars-5-0`, `bin/rename-rc-vars` | Eski `SHARELATEX_*` değişken adlarının `OVERLEAF_*` olarak tek seferlik taşınması. |

> [!WARNING]
>
> `bin/up` bir konteyneri yeniden oluşturduğunda, içinde yapılan her değişiklik kaybolur; örneğin `bin/shell` üzerinden kurulan paketler veya düzenlenen dosyalar. Yalnızca veri dizinleri (varsayılan olarak `data/`) ve `config/` korunur. Kalıcı değişiklikleri bunun yerine `config/variables.env`, `config/overleaf.rc` veya `config/docker-compose.override.yml` üzerinden yapın.

> [!NOTE]
>
> Her `bin/up` tüm kullanıcıların oturumunu kapatıyorsa `OVERLEAF_SESSION_SECRET` değerini ayarlayın. Bu değer olmadan oturum çerezleri, konteyner her yeniden oluşturulduğunda yeniden üretilen bir secret ile imzalanı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ü.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.