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

# Memutakhirkan deployment Anda

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

Berikut [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 citra Docker (di `config/version`) dikelola secara terpisah dari pembaruan kode Toolkit. Memperbarui kode Toolkit akan **tidak** secara otomatis mengubah versi citra Docker yang Anda jalankan. Ini berarti bahwa dalam sebagian besar kasus, Anda dapat meningkatkan versi Toolkit Anda tanpa meningkatkan deployment Anda.

#### Berikut `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 *default* versi citra Docker telah berubah, dan menawarkan untuk meningkatkan file versi lokal Anda (di `config/version`) agar sesuai dengan default 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 disalin secara otomatis ke `config/__old-version`, untuk berjaga-jaga jika Anda perlu kembali ke versi citra Docker tersebut.

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

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

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

{% hint style="info" %}
Untuk penyiapan air-gapped yang mengimpor citra Docker secara manual, silakan setel `PULL_BEFORE_UPGRADE=false` di `config/overleaf.rc` di 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>

Berikut `bin/upgrade` perintah akan selalu memilih versi Server Pro/CE terbaru yang tersedia untuknya saat itu. Jika siklus peningkatan Anda jarang, hal ini dapat menyebabkan versi mayor terlewati dan berpotensi meningkatkan ke versi yang mungkin tidak Anda harapkan.

Saat melakukan peningkatan, kami merekomendasikan untuk meningkatkan ke rilis terbaru dari versi mayor saat ini sebelum meningkatkan 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 berkonsultasi dengan [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, mendaftarlah ke [milis](https://mailchi.mp/overleaf.com/community-edition-and-server-pro) agar Anda dapat diberi tahu saat versi/pembaruan baru dirilis. Ini akan 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://overleaf-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.