Cara Upgrade Debian 12 ke Debian 13 Trixie dengan Aman

Server Debian 12 yang masih berjalan sekarang sudah lewat masa dukungan penuhnya, jadi upgrade ke Debian 13 sebaiknya masuk jadwal pemeliharaan terdekat.

Per 4 November 2026, halaman resmi Debian menyebut tiga tahun dukungan penuh Debian 12 Bookworm berakhir pada 11 Juli 2026. Bookworm kini masuk masa Long Term Support (LTS) sampai 30 Juni 2028, dan LTS hanya mencakup arsitektur i386, amd64, armhf, arm64, dan ppc64el. Debian 13 Trixie sendiri dirilis 9 Agustus 2025, dengan rilis titik terbarunya 13.7 pada 12 September 2026.

LTS memberi waktu, bukan alasan menunda tanpa batas. Langkah di bawah mengikuti catatan rilis resmi Debian 13 bagian upgrade, disederhanakan untuk server.

Langkah 1: backup dan snapshot

Upgrade versi mayor menyentuh hampir semua paket. Siapkan dua jaring pengaman:

• Snapshot VPS dari panel penyedia, bila tersedia. Ini jalan pulang tercepat bila server tidak bisa boot.
• Backup data dan konfigurasi di lokasi terpisah: database (dump), file aplikasi, dan folder yang disebut catatan rilis, yaitu /etc, /var/lib/dpkg, /var/lib/apt/extended_states, serta daftar paket dari dpkg --get-selections '*'.

Simpan juga daftar paket terpasang untuk pembanding nanti:

apt list --installed > ~/paket-sebelum.txt

Snapshot saja tidak cukup bila snapshot disimpan di server fisik yang sama. Alasannya dibahas di backup website otomatis.

Langkah 2: rapikan Bookworm dulu

Upgrade hanya didukung dari Bookworm. Pastikan versinya dan perbarui ke rilis titik terakhir:

cat /etc/debian_version
apt update && apt upgrade

Lalu periksa kondisi paket:

dpkg --audit
apt-mark showhold

dpkg --audit harus kosong. Paket yang ditahan (hold) bisa menghambat upgrade, lepas dengan apt-mark unhold nama-paket bila memang tidak perlu ditahan.

Cari juga paket yang bukan berasal dari Debian, misalnya dari repositori pihak ketiga:

apt list '?narrow(?installed, ?not(?origin(Debian)))'

Tinjau hasilnya sebelum menghapus apa pun, karena daftar ini bisa memuat paket yang dulu memang disediakan Debian. Hapus juga entri bookworm-backports dan repositori tidak resmi dari sumber apt untuk sementara.

Langkah 3: ganti sumber apt ke trixie

Catatan rilis menyarankan format deb822. Buat file /etc/apt/sources.list.d/debian.sources dengan isi berikut, lalu nonaktifkan baris lama di /etc/apt/sources.list dengan tanda #:

Types: deb
URIs: https://deb.debian.org/debian
Suites: trixie trixie-updates
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Types: deb
URIs: https://security.debian.org/debian-security
Suites: trixie-security
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Tambahkan contrib atau non-free di baris Components bila sebelumnya kamu memakainya. Lalu:

apt update

Langkah 4: siapkan sesi yang tahan putus

Jalankan upgrade di dalam tmux atau screen. Bila koneksi SSH putus di tengah proses, upgrade tetap berjalan dan kamu bisa menyambung kembali.

tmux new -s upgrade

Cek ruang disk terlebih dulu. Perintah berikut memperkirakan kebutuhan tanpa memasang apa pun:

apt -o APT::Get::Trivial-Only=true full-upgrade

Catatan rilis menyebut perintah ini bisa error bila dijalankan di awal proses. Kalau begitu, jalankan lagi setelah upgrade minimal di langkah 5. Bila ruang kurang, apt clean dan apt autoremove membantu. Hentikan juga layanan pemantauan seperti monit yang bisa mencoba menghidupkan ulang layanan di tengah upgrade.

Langkah 5: upgrade minimal, lalu upgrade penuh

Debian menyarankan dua tahap. Pertama, upgrade minimal yang tidak memasang paket baru:

apt upgrade --without-new-pkgs

Kedua, upgrade penuh:

apt full-upgrade

Bila muncul error "Could not perform immediate configuration", catatan rilis menyarankan mengulang dengan apt full-upgrade -o APT::Immediate-Configure=0.

Langkah 6: tangani prompt konfigurasi

Selama upgrade, apt akan bertanya bila file konfigurasi yang pernah kamu ubah, misalnya sshd_config atau konfigurasi Nginx, juga diubah oleh paket baru. Pilihannya biasanya: pertahankan versi milikmu, atau pakai versi dari paket.

Pegangan sederhananya: untuk file yang kamu sesuaikan sendiri, pertahankan versi milikmu, lalu bandingkan dengan versi baru setelah upgrade. Versi paket biasanya disimpan berdampingan dengan akhiran .dpkg-dist. Cari semuanya setelah selesai:

find /etc -name '*.dpkg-*' -o -name '*.ucf-*' -o -name '*.merge-error'

Untuk sshd_config, berhati-hatilah. Menerima versi paket bisa mengembalikan pengaturan seperti login password yang sudah kamu matikan. Pengaturan SSH yang disarankan ada di cara mengamankan VPS baru.

Langkah 7: kernel, reboot, dan pemeriksaan

Pastikan paket meta kernel terpasang agar kernel baru ikut diperbarui:

dpkg -l 'linux-image*' | grep ^ii | grep -i meta

Bila kosong, pasang linux-image-amd64 (untuk server amd64). Sebelum reboot, catatan rilis meminta membaca bagian hal yang perlu dilakukan sebelum reboot di bab isu Trixie. Setelah itu:

reboot

Begitu server hidup kembali, periksa:

cat /etc/debian_version
systemctl --failed
journalctl -p err -b

Uji layanan yang penting bagi bisnismu: website terbuka, database menerima koneksi, email terkirim, cron berjalan. Panduan membaca log ada di lokasi log penting di Linux.

Langkah 8: bersih-bersih

apt autoremove
apt modernize-sources

apt modernize-sources mengubah sisa sumber apt lama ke format deb822. Catatan rilis juga menyebut apt purge '?config-files' untuk membersihkan konfigurasi paket yang sudah dihapus, tapi ini ikut menghapus log paket tersebut, jadi backup dulu bila perlu. Terakhir, aktifkan kembali repositori pihak ketiga dengan versi untuk Trixie bila penyedianya sudah mendukung, lalu jalankan ulang layanan pemantauan.

Ringkasan perintah

Checklist sebelum mulai

• Snapshot VPS dan backup data di lokasi terpisah sudah ada
• Akses console dari panel penyedia sudah dicoba
• Bookworm sudah di rilis titik terakhir, dpkg --audit kosong
• Repositori pihak ketiga dan backports dinonaktifkan
• Upgrade dijalankan di dalam tmux atau screen
• Daftar layanan yang harus diuji setelah reboot sudah ditulis