> For the complete documentation index, see [llms.txt](https://overleaf-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://overleaf-pro.ayaka.space/on-premises/tr/bakim/upgrading-your-deployment.md).

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

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

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

Docker görüntüsü sürümünün (şurada `config/version`) Toolkit kod güncellemelerinden ayrı olarak yönetildiğini belirtmekte fayda var. Toolkit kodunu güncellemek **yapmamalısınız** çalıştırdığınız Docker görüntüsünün sürümünü otomatik olarak değiştirecektir. Bu da ç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

Siz şu komutu çalıştırdığınızda `bin/upgrade` komutunu çalıştırdığınızda, 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 reddedebilirsiniz ve hiçbir şey değişmez.

Toolkit kodunu güncellemeyi seçerseniz, betik ardından şunun olup olmadığını kontrol edecektir: *varsayılan* Docker görüntüsü 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ümleri değiştirmeyi seçerseniz, betik sizi Docker hizmetlerini kapatma, bir 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 görüntülerinin 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 **bir sonraki** ana sürüm. Dağıtımınız en son sürümün birden fazla ana sürüm gerisindeyse, çok aşamalı bir yükseltme yapmanız gerekecektir.

Örneğin, 3.5.10 çalıştırı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.

Şunu 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ümün birden fazla ana sürüm gerisindeyseniz, **yapmamalısınız** şunu kullanın `bin/upgrade` çünkü manuel, çok aşamalı bir yükseltme yapmanız gerekecektir.
{% endhint %}

{% hint style="info" %}
Docker görüntülerini manuel olarak içe aktaran air-gapped kurulumlar için lütfen şunu ayarlayın: `PULL_BEFORE_UPGRADE=false` şuradaki `config/overleaf.rc` dosyası.

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

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

Bu `bin/upgrade` komutu, o anda mevcut olan Server Pro/CE'nin en güncel sürümünü her zaman seçecektir. Yükseltme döngünüz seyrekse, bu büyük sürümlerin atlanmasına ve potansiyel olarak beklemediğiniz bir sürüme yükseltilmesine 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 kullanı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 şunu incelemenizi öneririz: [Sürüm notları](https://docs.overleaf.com/on-premises/release-notes) çü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ş betiklerini çalıştırmak.

Henüz yapmadıysanız, şuraya kaydolun: [e-posta listemize](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) böylece yeni sürümler/güncellemeler yayınlandığında bildirim alabilirsiniz. Bu, yayın takvimimizi yakından takip eden düzenli bakım aralıkları 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://overleaf-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.