SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor · Diperbarui 2026-10-15

Docker prune: Cara Mengosongkan Disk VPS

Disk VPS penuh karena Docker? Gunakan docker system df untuk menemukan image, container, cache build, atau volume yang memakan ruang sebelum prune.

Cari tahu apa yang menggunakan ruang disk sebelum menghapus apa pun

Docker menggunakan ruang disk pada VPS di 4 tempat: image, container yang dihentikan, cache build, dan volume lokal. Jalankan docker system df terlebih dahulu untuk mengetahui bagian mana yang menggunakan ruang tersebut, lalu jalankan perintah prune paling spesifik yang dapat menghapusnya. Urutan ini penting karena perintah terakhir dalam panduan ini, docker volume prune -a, menghapus data dan tidak dapat dibatalkan.

Mulai dari filesystem, bukan dari Docker.

df -h /
sudo du -xh --max-depth=1 /var/lib/docker | sort -h
sudo du -xh --max-depth=1 /var/lib/containerd | sort -h

df memberi tahu seberapa parah kondisinya. du memberi tahu lokasi penggunaan ruang tersebut. Flag -x membatasi du pada satu filesystem, sehingga perintah tersebut tidak mengikuti mount ke volume terpisah dan menghitungnya dua kali. Direktori yang perlu diperiksa bergantung pada storage backend. Pada instalasi baru Docker Engine 29.0 atau yang lebih baru, containerd image store adalah default. Isi image dan snapshot container berada di /var/lib/containerd, sehingga baris du kedua diperlukan. Pada kedua backend, ada 2 direktori di bawah /var/lib/docker yang perlu diperhatikan: volumes menyimpan data volume, sedangkan containers menyimpan metadata container dan file log. Host yang di-upgrade dari Docker versi lama tetap menggunakan layout overlay2 klasik sampai Anda mengubahnya. Pada layout tersebut, ada 3 direktori tambahan yang perlu diperhatikan: overlay2 menyimpan layer image dan container, buildkit menyimpan cache build, dan image menyimpan metadata layer. docker info | grep -i driver-type menampilkan io.containerd.snapshotter.v1 pada containerd image store dan tidak menampilkan apa pun pada overlay2. Containerd image store menyimpan salinan terkompresi dan salinan hasil ekstraksi dari setiap layer. Karena itu, image yang sama menggunakan lebih banyak ruang disk dibandingkan saat menggunakan overlay2.

Perhatikan sudo dan wildcard shell karena keduanya sering membuang waktu. /var/lib/docker dimiliki oleh root dan tidak dapat dibaca oleh user biasa Anda, sehingga ls /var/lib/docker menghasilkan Permission denied. Perintah seperti sudo du -sh /var/lib/docker/* juga gagal karena shell Anda memperluas * sebelum sudo dijalankan, dan shell tidak dapat membaca direktori tersebut. Semua perintah di bawah ini menggunakan find atau --max-depth sebagai pengganti wildcard karena alasan tersebut.

Sekarang, periksa tampilan dari Docker sendiri.

docker system df
TYPE            TOTAL     ACTIVE    SIZE      RECLAIMABLE
Images          24        6         12.4GB    8.91GB (71%)
Containers      31        6         1.42GB    1.39GB (97%)
Local Volumes   14        5         6.03GB    4.11GB (68%)
Build Cache     212       0         9.87GB    9.87GB

Angka tersebut berasal dari satu mesin dan tidak menunjukkan kondisi mesin Anda. Perhatikan bentuk datanya. TOTAL menghitung semua objek, ACTIVE menghitung objek yang sedang digunakan, dan RECLAIMABLE adalah perkiraan Docker tentang ruang yang dapat dibebaskan oleh prune dari baris tersebut.

Ada 2 hal tentang RECLAIMABLE yang sering membingungkan. Perintah ini menghitung shared image layer satu kali untuk setiap image yang menggunakannya, sehingga baris image biasanya memperkirakan ruang yang lebih besar daripada ruang yang benar-benar dapat dibebaskan. Perintah ini juga tidak pernah menyertakan file log container karena Docker tidak menganggap file log sebagai objek yang dapat direklamasi. Jika du melaporkan direktori yang jauh lebih besar daripada yang diakui oleh docker system df, penyebabnya adalah file log. Penjelasannya tersedia pada bagian di bawah ini.

Tambahkan -v untuk melihat rincian per objek.

docker system df -v

Perintah tersebut membagi ringkasan menjadi satu bagian untuk setiap jenis objek. Bagian image menambahkan kolom SHARED SIZE dan UNIQUE SIZE, sehingga Anda dapat melihat penggunaan ruang sebenarnya dari satu image. Bagian volume menambahkan jumlah LINKS, yaitu jumlah container yang terhubung ke volume tersebut. Ingat LINKS karena nilai 0 berarti tidak ada container yang menggunakan volume tersebut. Kondisi inilah yang menjadi dasar setiap perintah volume prune.

Perbedaan antara dangling image dan image yang tidak digunakan

Kedua istilah ini tampak dapat dipertukarkan, tetapi tidak. Filter berperilaku berbeda karena objeknya berbeda.

Dangling image adalah image tanpa tag. Image ini ditampilkan sebagai <none> di docker images. Anda membuatnya setiap kali melakukan build ulang: docker build -t myapp:latest . memindahkan tag myapp:latest ke image baru, sedangkan image lama tetap menyimpan semua layer-nya tetapi kehilangan namanya. Tidak ada yang merujuknya, dan image ini tidak dibersihkan secara otomatis.

Image yang tidak digunakan adalah image apa pun, baik memiliki tag maupun tidak, yang saat ini tidak dirujuk oleh container mana pun. postgres:16 yang Anda pull bulan lalu dan tidak dirujuk oleh container mana pun, baik yang sedang berjalan maupun yang berhenti, termasuk image yang tidak digunakan dan bukan dangling image.

docker image prune        # dangling images only
docker image prune -a     # every image no container refers to

Perintah kedua akan meminta konfirmasi terlebih dahulu.

WARNING! This will remove all images without at least one container associated to them.
Are you sure you want to continue? [y/N]

Baca prompt tersebut dengan saksama. "Associated to them" berarti object container yang sudah ada, baik yang sedang berjalan maupun yang berhenti. Jika Anda menjalankan docker compose down, container tersebut akan dihapus. Akibatnya, setiap image yang digunakan service tersebut menjadi tidak digunakan, dan -a menghapus semuanya. Tidak ada data yang hilang secara permanen, tetapi docker compose up -d berikutnya akan melakukan pull ulang atau build ulang semuanya. Pada VPS kecil, proses ini menghabiskan bandwidth dan waktu build. Inilah salah satu alasan praktis untuk memahami hal yang dihapus oleh docker compose down dan hal yang tetap berjalan setelah stop sebelum menghapus image.

Filter dapat mengecualikan image yang masih baru.

docker image prune -a --filter "until=240h"

Perintah tersebut menghapus image yang tidak digunakan dan dibuat lebih dari 240 jam (10 hari) lalu, serta membiarkan image yang lebih baru. Nilai until menerima string durasi Go seperti 240h atau timestamp absolut seperti 2026-08-01T00:00:00.

Apa itu cache build dan mengapa ukurannya menjadi sangat besar

BuildKit adalah builder yang secara default digunakan Docker untuk docker build dan docker compose build sejak Docker Engine 23.0. BuildKit menyimpan hasil setiap langkah dari setiap Dockerfile yang dijalankannya. Pada tata letak overlay2 klasik, cache tersebut disimpan di /var/lib/docker/buildkit. Cache ini membuat build kedua selesai dalam hitungan detik, sehingga cache berfungsi sebagaimana mestinya. Docker Engine secara default menjalankan garbage collection pada cache tersebut. Cache yang tidak digunakan selama 60 hari akan dihapus. Cache lainnya baru dipangkas setelah melewati batas yang ditentukan Docker Engine berdasarkan ukuran disk. Pada VPS kecil, hal ini dapat berarti disk sudah hampir penuh sebelum pembersihan dilakukan. Jika image yang sama dibuat 50 kali dengan langkah COPY yang berubah setiap kali, Anda akan menyimpan 50 set layer sampai garbage collection berjalan.

Cache build tidak terlihat oleh docker image prune. Cache tersebut merupakan jenis objek terpisah dengan perintahnya sendiri.

docker builder prune                        # dangling cache
docker builder prune -a                     # all unused cache
docker builder prune --filter until=168h    # cache untouched for 7 days

Tidak satu pun dari perintah ini menyentuh image atau data Anda. Satu-satunya dampak penghapusan cache build adalah build berikutnya berjalan lebih lambat satu kali. Pada VPS yang rutin melakukan rebuild image, Build Cache sering menjadi baris terbesar dalam docker system df. Karena itu, cache tersebut merupakan objek besar yang paling aman untuk dihapus.

Perintah prune, dari yang aman hingga destruktif

Ikuti daftar ini dari atas ke bawah dan berhenti segera setelah df -h / kembali terlihat normal. Setiap perintah menampilkan baris Total reclaimed space: setelah selesai.

  1. docker container prune menghapus container yang telah berhenti. Writable layer-nya juga dihapus, sehingga semua data yang ditulis container di luar volume ikut terhapus. Volume tidak disentuh.
  2. docker image prune hanya menghapus image yang dangling. Ini adalah perintah image yang paling aman.
  3. docker builder prune menghapus build cache yang dangling. Dampaknya adalah satu proses build yang lebih lambat.
  4. docker image prune -a menghapus setiap image yang tidak digunakan oleh container mana pun. Dampaknya adalah image harus di-pull ulang atau di-build ulang.
  5. docker system prune menjalankan tiga langkah pertama sekaligus dan juga menambahkan network yang tidak digunakan.
  6. docker volume prune menghapus anonymous volume yang tidak digunakan.
  7. docker volume prune -a menghapus volume yang tidak digunakan, termasuk volume bernama. Perintah inilah yang dapat menghapus database.

docker system prune menyatakan cakupannya sendiri sebelum dijalankan.

WARNING! This will remove:
        - all stopped containers
        - all networks not used by at least one container
        - all dangling images
        - unused build cache
Are you sure you want to continue? [y/N]

Volume sengaja tidak disertakan dalam daftar tersebut. Menambahkan --volumes memasukkan anonymous volume kembali ke dalam cakupan. Menambahkan -a memperluas langkah image, dari hanya image yang dangling menjadi semua image yang tidak digunakan. Menjalankan docker system prune -a --volumes -f secara penuh pada host production dapat menyebabkan kehilangan data saat mencoba mengosongkan ruang.

Mengapa prune volume menghapus database Anda

Bagian ini perlu dibaca dua kali.

Sebuah volume dianggap tidak digunakan jika tidak ada container yang terpasang padanya. Hanya itu pemeriksaannya. Docker tidak memeriksa apakah volume kosong, apakah file compose masih mendeklarasikannya, atau apakah volume tersebut menyimpan satu-satunya salinan database Anda. LINKS 0 dalam docker system df -v berarti tidak digunakan, dan docker volume prune -a memperlakukan setiap volume yang tidak digunakan sebagai target yang dapat dihapus, kecuali filter label yang Anda tambahkan mengecualikannya.

Sekarang, jalankan dua tindakan biasa secara berurutan. Anda menjalankan docker compose down untuk me-restart stack dengan bersih. Perintah tersebut menghapus container dan membiarkan named volume tetap ada, sesuai dokumentasinya. Volume Postgres Anda kini tidak terpasang pada apa pun. Sepuluh menit kemudian, Anda menjalankan docker volume prune -a untuk mengosongkan ruang, dan database tersebut hilang. Kedua perintah berjalan sesuai fungsinya. Urutan tersebut menghancurkan data.

Sejak Docker Engine 23.0 (API version 1.42), perintah tanpa opsi tersebut memiliki cakupan yang lebih sempit daripada sebelumnya.

WARNING! This will remove anonymous local volumes not used by at least one container.

Anonymous volume adalah volume yang dibuat Docker untuk Anda, biasanya karena image mendeklarasikan VOLUME dan Anda tidak memberinya nama. Volume tersebut biasanya menyimpan data yang tidak secara khusus ingin Anda pertahankan. Named volume, yaitu volume yang Anda tulis dalam file compose, hanya dihapus jika Anda menambahkan -a. Versi Docker yang lebih lama menghapus keduanya dengan perintah tanpa opsi tersebut. Karena itu, jangan mengandalkan kebiasaan yang terbentuk pada server yang sudah Anda upgrade. Perbedaan ini baru masuk akal setelah Anda memahami perbedaan named volume dan bind mount, karena bind mount bukan Docker volume dan tidak akan pernah disentuh oleh perintah prune.

Periksa sebelum menghapus. Ganti myapp_pgdata dengan nama volume yang sedang Anda periksa.

docker volume ls -f dangling=true
docker volume inspect myapp_pgdata
sudo ls -la /var/lib/docker/volumes/myapp_pgdata/_data

Filter dangling=true pada volume berarti tidak direferensikan, bukan kosong. Menampilkan _data akan memperlihatkan isi sebenarnya. Jika Anda menemukan direktori pgdata atau mysql di dalamnya, berhenti dan buat salinan sebelum melanjutkan. Kerusakan yang sama juga dapat terjadi melalui docker compose down -v. Perintah tersebut menghapus named volume yang dideklarasikan oleh file compose, kecuali volume yang ditandai external, dan tidak meminta konfirmasi terlebih dahulu.

Volume adalah satu-satunya hal pada host Docker yang tidak dapat dibuat ulang melalui rebuild. Karena itu, data volume harus disimpan dalam backup restic yang berjalan di luar server, sehingga flag yang salah ketik tidak dapat menjangkaunya.

Jika tidak ada yang terpangkas: file log container

Anda telah memangkas semuanya, docker system df hampir tidak menunjukkan apa pun yang dapat direklamasi, tetapi disk masih penuh. Periksa log.

sudo find /var/lib/docker/containers -name '*-json.log' -exec du -h {} + | sort -h | tail -10

Setiap container menulis standard output dan standard error ke dalam file JSON di bawah /var/lib/docker/containers/. Pada instalasi default, max-size tidak ditetapkan, yang berarti ukurannya tidak terbatas. Akibatnya, satu container yang terus-menerus mengalami crash loop dapat menulis hingga partisi penuh. Tidak ada perintah prune yang menghapus file ini karena container yang membuatnya masih berjalan. Berdasarkan definisinya, file tersebut tidak dapat dipangkas.

Jangan hapus file tersebut. Menjalankan rm pada file log yang terbuka tidak membebaskan ruang karena daemon Docker masih memegang file descriptor yang terbuka. Kernel akan tetap mempertahankan blok tersebut sebagai teralokasi hingga handle itu ditutup. df tidak akan berubah sama sekali. Sebagai gantinya, lakukan truncate. Cara ini mempertahankan inode yang sama dan memungkinkan daemon melanjutkan penulisan.

sudo find /var/lib/docker/containers -name '*-json.log' -exec truncate -s 0 {} +
df -h /

Ini hanya perbaikan sementara. docker logs untuk container tersebut kini tidak mengembalikan apa pun, dan file akan segera membesar lagi. Perbaikan yang sebenarnya adalah rotasi log, yang dibahas pada bagian berikutnya.

Ukur sebelum dan sesudah, setiap kali

Jangan menebak hasil prune. Ambil satu pengukuran, jalankan satu perintah, lalu ambil pengukuran lain.

df -h /
docker system df
docker builder prune -f --filter until=168h
docker image prune -f
docker system df
df -h /

Bandingkan kedua output df. Hanya angka ini yang menentukan apakah server Anda tetap melayani permintaan. Selanjutnya, docker system df menunjukkan baris yang benar-benar berubah, dan setiap prune mencetak angka Total reclaimed space: miliknya sendiri.

Jika df tidak berubah tetapi docker system df menunjukkan bahwa ruang telah dibebaskan, berarti file handle yang masih terbuka menahan blok yang telah dihapus. Inilah masalah file log yang dijelaskan di atas. Jika keduanya berubah tetapi disk kembali penuh dalam satu hari, masalahnya adalah pertumbuhan data, bukan pembersihan. Solusinya adalah rotation dan scheduled job.

Cara mencegah disk penuh kembali

Batasi ukuran log. Buat atau edit /etc/docker/daemon.json.

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}

Konfigurasi tersebut membatasi log setiap container yang dibuat setelah restart menjadi maksimal 30 MB. Setiap nilai di bawah log-opts harus berupa string, termasuk nilai numerik. Pastikan file tersebut terurai dengan benar sebelum Anda melakukan restart, karena daemon.json yang salah format akan membuat daemon gagal start dan mematikan semua container.

python3 -m json.tool /etc/docker/daemon.json
sudo systemctl restart docker
docker info | grep -i 'logging driver'

docker info sekarang seharusnya melaporkan Logging Driver: json-file. Batasan tersebut akan muncul di bagian LogConfig dari docker inspect pada container yang dibuat setelah restart. Ini adalah detail penting: pengaturan ini hanya berlaku untuk container baru. Container yang sudah ada tetap menggunakan konfigurasi saat mereka dibuat, jadi Anda harus membuatnya ulang.

docker compose up -d --force-recreate

Batasan yang sama dapat diterapkan per service di dalam file compose, yang merupakan pilihan lebih baik jika satu service yang berisik memerlukan angka batasnya sendiri.

services:
  app:
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

Jadwalkan prune terbatas. Jalankan setiap minggu dan batasi cakupannya pada image yang menggantung (dangling) serta cache build lama. Jangan pernah memasukkan -a atau --volumes ke dalam pekerjaan terjadwal, karena pekerjaan yang berjalan saat stack sedang down akan menghapus image stack tersebut, dan dengan --volumes, proses tersebut akan mulai menghapus data Anda.

sudo tee /etc/cron.weekly/docker-prune >/dev/null <<'EOF'
#!/bin/sh
docker image prune -f
docker builder prune -f --filter until=168h
EOF
sudo chmod +x /etc/cron.weekly/docker-prune
sudo /etc/cron.weekly/docker-prune

Baris terakhir tersebut menjalankan skrip secara manual satu kali agar Anda dapat melihat outputnya sebelum skrip berjalan tanpa pengawasan. File tersebut harus dapat dieksekusi (executable), dan namanya tidak boleh mengandung titik, karena run-parts akan melewati file yang tidak dapat dieksekusi dan file yang memiliki ekstensi.

Pasang alarm ruang kosong. Prune yang Anda jalankan setelah disk penuh adalah tindakan pemulihan. Peringatan pada 80 persen adalah tindakan pencegahan.

usage=$(df --output=pcent / | tr -dc '0-9')
[ "$usage" -ge 80 ] && echo "root filesystem at ${usage} percent full"

Masukkan perintah tersebut ke dalam cron dengan notifikasi apa pun yang sudah Anda gunakan. Ruang kosong hanyalah separuh dari gambaran keseluruhan, jadi pasangkan alarm tersebut dengan pemantauan kesehatan disk pada VPS Anda, karena disk yang rusak dan disk yang penuh sama-sama akan menghentikan container Anda, dan keduanya memerlukan perbaikan yang berbeda.

Semua langkah di atas mengasumsikan instalasi standar dengan root data di /var/lib/docker. Jika Anda memindahkannya dengan kunci data-root di daemon.json, ganti path tersebut di setiap perintah. Pada penyimpanan image containerd, data-root tidak memindahkan data image dan container di /var/lib/containerd, karena lokasi tersebut diatur oleh root di /etc/containerd/config.toml. Mengatur tata letak tersebut dengan benar pada server baru adalah bagian dari pengaturan Docker pada VPS, dan jauh lebih mudah untuk diputuskan sebelum Anda memiliki 40 GB container yang tersimpan di partisi yang salah.

FAQ

Apakah docker system prune menghapus volume saya?

Tidak. Perintah biasa menghapus container yang berhenti, network yang tidak digunakan, image tanpa tag, dan cache build yang tidak digunakan. Prompt konfirmasinya mencantumkan tepat kumpulan tersebut. Volume baru ikut diproses jika Anda menambahkan --volumes. Sejak Docker Engine 23.0, flag tersebut mencakup volume anonim, bukan volume bernama. Volume bernama dihapus oleh docker volume prune -a dan docker compose down -v. Kedua perintah tersebut harus digunakan dengan hati-hati.

Mengapa disk saya masih penuh setelah menjalankan docker prune?

Ada dua penyebab umum. Pertama, file log container di bawah /var/lib/docker/containers/. Tidak ada perintah prune yang menyentuh file tersebut, dan ukurannya terus bertambah tanpa batas sampai Anda menetapkan max-size. Kedua, ada file yang sudah dihapus tetapi masih terbuka karena ditahan oleh suatu proses. Jika Anda menghapus log dengan rm saat container masih berjalan, daemon tetap mempertahankan file descriptor tersebut dan kernel tidak membebaskan bloknya. Karena itu, df tidak menunjukkan perubahan. Bandingkan sudo du -xh --max-depth=1 /var/lib/docker dengan docker system df untuk mengetahui penyebabnya.

Apa perbedaan antara docker image prune dan docker image prune -a?

Perintah biasa hanya menghapus image tanpa tag, yaitu image yang kehilangan tag, hampir selalu karena proses build ulang. Bentuk -a menghapus setiap image yang tidak dirujuk oleh container yang ada, termasuk image bertag yang sengaja Anda pull. Setelah docker compose down, container sudah tidak ada, sehingga -a akan menghapus image milik stack tersebut. Tidak ada data yang hilang secara permanen karena start berikutnya akan melakukan pull atau build ulang. Namun, pada koneksi yang lambat, proses ini dapat memerlukan waktu lama.

Bagaimana cara mencegah log Docker memenuhi disk?

Tetapkan max-size dan max-file di bawah log-opts dalam /etc/docker/daemon.json, lalu restart daemon dengan sudo systemctl restart docker. Pengaturan tersebut hanya berlaku untuk container yang dibuat setelah restart itu. Karena itu, buat ulang container yang sedang berjalan dengan docker compose up -d --force-recreate. Anda dapat menetapkan dua opsi yang sama untuk setiap service dalam file compose di bawah key logging. Gunakan cara ini jika satu service menghasilkan log jauh lebih banyak daripada service lainnya.

Apakah aman menjalankan docker system prune dalam cron job?

docker system prune -f biasa aman pada host yang seluruh stack-nya selalu berjalan. Namun, perintah tersebut menghapus container yang berhenti. Dengan demikian, container yang sengaja Anda hentikan untuk dijalankan kembali nanti juga akan terhapus. Job terjadwal yang lebih aman adalah docker image prune -f ditambah docker builder prune -f --filter until=168h. Perintah tersebut membebaskan dua jenis data yang ukurannya paling cepat bertambah dan tidak dapat menyentuh volume. Jangan pernah menjadwalkan -a atau --volumes.

Apakah artikel ini bermanfaat?