Cara Update Aplikasi Docker di CasaOS ke Versi Terbaru (Manual & Otomatis)

Salah satu hal yang sering terlewat saat mengelola homelab dengan CasaOS adalah update aplikasi. Berbeda dengan aplikasi di smartphone yang update otomatis, aplikasi Docker di CasaOS tidak memperbarui dirinya sendiri secara bawaan. Jika dibiarkan, kamu bisa ketinggalan fitur baru, perbaikan bug, atau — yang lebih penting — patch keamanan.

Artikel ini membahas dua cara update aplikasi Docker di CasaOS: secara manual (untuk kontrol penuh) dan otomatis menggunakan Watchtower.

Mengapa Aplikasi Docker Tidak Update Otomatis?

#

Ketika kamu menginstall aplikasi di CasaOS, yang diunduh sebenarnya adalah Docker image — semacam “snapshot” dari aplikasi tersebut pada versi tertentu. Image ini tersimpan di lokal dan tidak berubah kecuali kamu secara aktif menariknya kembali dari internet.

CasaOS sendiri secara resmi tidak menyediakan fitur auto-update untuk aplikasi. Alasannya adalah menjaga stabilitas — update mendadak bisa menyebabkan masalah kompatibilitas. Namun bukan berarti tidak ada cara otomatisnya.

Cara 1: Update Manual via Terminal (Direkomendasikan)

#

Cara ini memberi kontrol penuh atas proses update. Kamu bisa memilih kapan update dilakukan dan memastikan tidak ada yang berjalan saat proses berlangsung.

Langkah 1: Cari nama container aplikasi

#

docker ps

Contoh output:

CONTAINER ID   IMAGE                NAMES
a1b2c3d4       jellyfin/jellyfin    jellyfin
f5e6g7h8       vaultwarden/server   vaultwarden

Langkah 2: Tarik image versi terbaru

#

docker pull nama-image:tag

Contoh untuk Jellyfin:

docker pull jellyfin/jellyfin:latest

Untuk aplikasi yang menggunakan tag versi spesifik, cek terlebih dahulu di Docker Hub untuk versi terbaru yang tersedia.

Langkah 3: Stop container yang sedang berjalan

#

docker stop nama-container

Contoh:

docker stop jellyfin

Langkah 4: Hapus container lama (data tidak ikut terhapus)

#

docker rm nama-container

💡 Jangan khawatir, data aplikasi tersimpan di volume/bind mount, bukan di dalam container. Menghapus container tidak menghapus data.

Langkah 5: Jalankan ulang container dengan image baru

#

Jika menggunakan Docker Compose (direkomendasikan):

cd /path/ke/folder/docker-compose
docker compose up -d

Jika menjalankan ulang via CasaOS GUI, cukup buka dashboard → klik ikon aplikasi → pilih “Start”. CasaOS akan otomatis menggunakan image terbaru yang sudah diunduh.

Langkah 6: Bersihkan image lama

#

Setelah update berhasil, image lama masih tersimpan di storage. Bersihkan untuk menghemat ruang:

docker image prune -f

Cara 2: Update Satu Perintah (Cepat)

#

Untuk update cepat tanpa langkah-langkah panjang, gunakan kombinasi perintah ini:

# Tarik image terbaru
docker pull nama-image:latest
 
# Restart container agar menggunakan image baru
docker stop nama-container && docker rm nama-container
 
# Jalankan ulang (jika tidak pakai Compose, sesuaikan dengan konfigurasi aslinya)
docker run -d --name nama-container ... nama-image:latest

⚠️ Cara ini lebih cocok jika kamu sudah hafal konfigurasi container. Untuk aplikasi yang dipasang via CasaOS GUI, lebih aman menggunakan langkah bertahap di Cara 1.

Cara 3: Update Otomatis dengan Watchtower

#

Watchtower adalah aplikasi Docker yang bertugas memantau semua container yang sedang berjalan dan secara otomatis menarik image baru jika tersedia, lalu me-restart container dengan image terbaru.

⚠️ Catatan penting: Watchtower direkomendasikan untuk homelab dan penggunaan personal, bukan untuk lingkungan produksi yang membutuhkan kontrol ketat atas versi. Watchtower juga sudah diarsipkan oleh pengembangnya pada Desember 2025 — tidak ada update baru, tapi masih stabil untuk digunakan.

Install Watchtower via CasaOS App Store

#

Cari “Watchtower” di App Store CasaOS dan install langsung dari sana.

Install Watchtower via Terminal

#

docker run -d \
  --name watchtower \
  --restart unless-stopped \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower

Secara default, Watchtower akan memeriksa pembaruan setiap 24 jam.

Konfigurasi Watchtower (Opsional)

#

Ubah interval pemeriksaan (misalnya setiap 6 jam):

docker run -d \
  --name watchtower \
  --restart unless-stopped \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --interval 21600

Jalankan Watchtower hanya sekali (update sekarang, lalu berhenti):

docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --run-once

Monitor-only mode (Watchtower hanya memberitahu ada update, tidak langsung menerapkan):

docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --monitor-only

Cek log Watchtower untuk melihat aktivitasnya

#

docker logs watchtower --tail 50

Perbandingan Metode Update

#

Tips Aman Sebelum Update

#

1. Backup data dulu sebelum update aplikasi penting:

   sudo cp -r /DATA/AppData/nama-app /home/user/backup-nama-app

2. Baca changelog versi baru di halaman Docker Hub atau GitHub aplikasi tersebut — beberapa update membutuhkan migrasi database atau perubahan konfigurasi.

3. Update satu aplikasi dulu, tunggu beberapa hari, baru update yang lain. Ini memudahkan identifikasi jika ada yang bermasalah.

Kesimpulan

#

Update aplikasi Docker di CasaOS bisa dilakukan dengan:

• Manual via terminal — paling aman dan terkontrol
• Watchtower — praktis untuk homelab yang tidak butuh kontrol ketat

Disarankan untuk setidaknya melakukan update manual sekali sebulan pada aplikasi yang aktif digunakan, terutama yang terhubung ke internet atau menyimpan data sensitif.

Referensi: Watchtower Docs | CasaOS Official | Docker Hub