> 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/id/pemeliharaan/upgrading-your-deployment.md).

# Meningkatkan deployment Anda

{% hint style="danger" %}
Penting untuk memastikan bahwa Anda melakukan [cadangan yang konsisten](/on-premises/id/pemeliharaan/data-and-backups.md#performing-a-consistent-backup) **sebelum** pada setiap peningkatan versi major agar Anda dapat melakukan rollback jika diperlukan.
{% endhint %}

Bagian [Overleaf Toolkit↗](https://github.com/overleaf/toolkit) adalah repositori git, jadi mudah untuk mendapatkan fitur Toolkit baru. Cukup jalankan `bin/upgrade` perintah dan ikuti petunjuk di layar.

Perlu dicatat bahwa versi image Docker (pada `config/version`) dikelola terpisah dari pembaruan kode Toolkit. Memperbarui kode Toolkit akan **tidak** secara otomatis mengubah versi image Docker yang Anda jalankan. Ini berarti bahwa dalam kebanyakan kasus, Anda dapat meningkatkan versi Toolkit tanpa meningkatkan deployment Anda.

#### Bagian `bin/upgrade` Skrip

Saat Anda menjalankan `bin/upgrade` perintah, skrip akan memeriksa apakah ada pembaruan yang tersedia untuk kode Toolkit, dan menawarkan untuk memperbarui Toolkit Anda. Anda selalu dapat menolak peningkatan ini, dan tidak ada yang akan berubah.

Jika Anda memilih untuk memperbarui kode Toolkit, skrip kemudian akan memeriksa apakah *bawaan* versi image Docker telah berubah, dan menawarkan untuk meningkatkan file versi lokal Anda (di `config/version`) agar sesuai dengan bawaan baru.

Jika Anda memilih untuk beralih versi, skrip kemudian akan memandu Anda melalui proses mematikan layanan Docker, membuat cadangan, dan memulai ulang layanan Docker. File versi lama Anda akan secara otomatis disalin ke `config/__old-version`, kalau-kalau Anda perlu kembali ke versi image Docker tersebut.

{% hint style="danger" %}
Saat melakukan peningkatan Server CE/Pro, kami merekomendasikan peningkatan ke rilis terbaru dari versi major yang sedang digunakan **sebelum** meningkatkan ke rilis terbaru dari **berikutnya** versi major. Jika deployment Anda tertinggal lebih dari satu versi major dari yang terbaru, Anda akan diwajibkan melakukan peningkatan bertahap.

Misalnya, jika Anda menjalankan 3.5.10, Anda perlu meningkatkan ke 3.5.13 -> Lakukan migrasi Full Project History -> 4.2.9 -> 5.5.4.

Anda sebaiknya **jangan pernah** melewati versi major (3.5.10 -> 5.5.4). Jika Anda menggunakan Toolkit, dan tertinggal lebih dari satu versi major dari yang terbaru, Anda harus **tidak** menggunakan `bin/upgrade` skrip tersebut karena Anda perlu melakukan peningkatan bertahap secara manual.
{% endhint %}

{% hint style="info" %}
Untuk pengaturan air-gapped yang mengimpor image Docker secara manual, silakan setel `PULL_BEFORE_UPGRADE=false` di `config/overleaf.rc` file.

Silakan periksa [di sini](/on-premises/id/instalasi/air-gapped-offline-deployments.md) untuk informasi lebih lanjut tentang penerapan di lingkungan air-gapped/offline.
{% endhint %}

### Jalur peningkatan <a href="#upgrade-path" id="upgrade-path"></a>

Bagian `bin/upgrade` perintah akan selalu memilih versi Server Pro/CE terbaru yang tersedia pada saat itu. Jika siklus peningkatan Anda jarang, ini dapat mengakibatkan melewati versi mayor dan berpotensi meningkatkan ke versi yang mungkin tidak Anda duga.

Saat melakukan peningkatan, kami merekomendasikan untuk memperbarui ke rilis terbaru dari versi mayor saat ini sebelum memperbarui ke rilis terbaru dari versi mayor berikutnya. Misalnya, jika Anda saat ini menjalankan 3.3.2 dan versi terbaru yang tersedia adalah 5.3.1, jalur peningkatan yang benar adalah:

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

Untuk menghindari masalah peningkatan apa pun, kami menyarankan untuk melihat [Catatan rilis](https://docs.overleaf.com/on-premises/release-notes) sebelum melakukan peningkatan apa pun karena versi tertentu mungkin memerlukan langkah tambahan. Seperti, melakukan perubahan manual pada Toolkit, meningkatkan basis data, atau menjalankan skrip migrasi.

Jika Anda belum melakukannya, mendaftar ke [milis](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) agar Anda dapat diberi tahu saat versi/pembaruan baru dirilis. Ini memungkinkan Anda menjadwalkan jendela pemeliharaan rutin yang mengikuti jadwal rilis kami dengan dekat.


---

# 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/id/pemeliharaan/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.