> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/tr/bakim/upgrading-your-deployment.md).

# Dağıtımınızı yükseltme

{% hint style="danger" %}
bir [tutarlı yedekleme](/on-premises/tr/bakim/data-and-backups.md#performing-a-consistent-backup) **önce** her ana sürüm yükseltmesinde, gerekirse geri dönebilmenizi sağlamak için.
{% endhint %}

Bu [Overleaf Toolkit↗](https://github.com/overleaf/toolkit) bir git deposudur, bu yüzden yeni Toolkit özelliklerini almak kolaydır. Sadece `bin/upgrade` komutunu çalıştırın ve ekrandaki istemleri izleyin.

Docker imajı sürümünün (şurada `config/version`) Toolkit kodu güncellemelerinden ayrı olarak yönetildiğini belirtmekte fayda var. Toolkit kodunu güncellemek **kullanmayın** çalıştırdığınız Docker imajının sürümünü otomatik olarak değiştirecektir. Bu, çoğu durumda dağıtımınızı yükseltmeden Toolkit sürümünüzü yükseltebileceğiniz anlamına gelir.

#### Bu `bin/upgrade` Betik

Şunu çalıştırdığınızda `bin/upgrade` komutu, betik Toolkit kodu için mevcut bir güncelleme olup olmadığını kontrol edecek ve Toolkit'inizi güncellemeyi teklif edecektir. Bu yükseltmeyi her zaman hayır diyerek reddedebilirsiniz ve hiçbir şey değişmez.

Toolkit kodunu güncellemeyi seçerseniz, betik ardından şunun *varsayılan* Docker imajı sürümünün değişip değişmediğini kontrol edecek ve yerel sürüm dosyanızı (şurada `config/version`) yeni varsayılanla eşleşecek şekilde yükseltmeyi teklif edecektir.

Sürümler arasında geçiş yapmayı seçerseniz, betik sizi Docker hizmetlerini durdurma, yedek alma ve Docker hizmetlerini yeniden başlatma sürecinde yönlendirecektir. Eski sürüm dosyanız otomatik olarak şuraya kopyalanacaktır `config/__old-version`, Docker imajlarının o sürümüne geri dönmeniz gerekirse diye.

{% hint style="danger" %}
Server CE/Pro yükseltmesi yaparken, dağıtılmış ana sürümün en son sürümüne yükseltmenizi öneririz **önce** şunun en son sürümüne yükseltmeden **sonraki** ana sürüm. Dağıtımınız en son sürümün birden fazla ana sürüm gerisindeyse, çok adımlı bir yükseltme yapmanız gerekecektir.

Örneğin, 3.5.10 kullanıyorsanız, 3.5.13'e yükseltmeniz gerekecek -> Tam Proje Geçmişi geçişini gerçekleştirin -> 4.2.9 -> 5.5.4.

Yapmalısınız **asla** ana sürümleri atlamayın (3.5.10 -> 5.5.4). Toolkit kullanıyorsanız ve en son sürümden birden fazla ana sürüm gerideyseniz, yapmanız gerekir **kullanmayın** betiği `bin/upgrade` çünkü manuel çok adımlı bir yükseltme yapmanız gerekecektir.
{% endhint %}

{% hint style="info" %}
Docker imajlarını manuel olarak içe aktaran ağdan izole kurulumlar için lütfen şunu ayarlayın `PULL_BEFORE_UPGRADE=false` şunun içinde `config/overleaf.rc` dosyası.

Lütfen kontrol edin [burada](/on-premises/tr/kurulum/air-gapped-offline-deployments.md) ağdan izole/çevrimdışı ortamlarda dağıtım yapma hakkında daha fazla bilgi için.
{% endhint %}

### Yükseltme yolu <a href="#upgrade-path" id="upgrade-path"></a>

Bu `bin/upgrade` komutu, her zaman o anda mevcut olan en güncel Server Pro/CE sürümünü seçecektir. Yükseltme döngünüz seyrekse, bu durum ana sürümleri atlamanıza ve muhtemelen beklemediğiniz bir sürüme yükseltme yapmanıza yol açabilir.

Bir yükseltme yaparken, bir sonraki ana sürümün en son sürümüne yükseltmeden önce mevcut ana sürümün en son sürümüne yükseltmenizi öneririz. Örneğin, şu anda 3.3.2 çalıştırıyorsanız ve mevcut en son sürüm 5.3.1 ise, doğru yükseltme yolu şu olur:

* 3.3.2 -> 3.5.13
* 3.5.13 -> 4.2.9
* 4.2.9 -> 5.5.1

Herhangi bir yükseltme sorununu önlemek için şunlara danışmanızı öneririz [Sürüm notları](https://docs.overleaf.com/on-premises/release-notes) herhangi bir yükseltme yapmadan önce, çünkü bazı sürümler ek adımlar gerektirebilir. Örneğin, Toolkit'te manuel değişiklikler yapmak, veritabanlarını yükseltmek veya geçiş betikleri çalıştırmak.

Henüz yapmadıysanız, şunlara kaydolmanız [e-posta listemize](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) böylece yeni sürümler/güncellemeler yayınlandığında bilgilendirilebilirsiniz. Bu, yayın takvimimizi yakından takip eden düzenli bakım pencereleri planlamanıza olanak tanır.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/on-premises/tr/bakim/upgrading-your-deployment.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.