Cara memindahkan root directory Docker Engine (/var/lib/docker) dan containerd (/var/lib/containerd) secara menyeluruh ke disk atau partisi eksternal (seperti SSD tambahan atau USB flashdisk). Saat menjalankan infrastruktur berbasis container di perangkat dengan storage internal terbatas—seperti VPS kapasitas kecil atau Single-Board Computer (SBC) dengan eMMC 8GB/16GB—ruang penyimpanan root (/) sangat cepat penuh oleh image, volume, dan cache layer aplikasi.
Pada arsitektur Docker Engine modern, penyimpanan data terbagi menjadi dua direktori terpisah: /var/lib/docker milik Docker Engine dan /var/lib/containerd milik containerd.
- Kapan Harus Dipindahkan?
- Langkah Memindahkan Root Directory Docker & Containerd
- Siapkan Partisi dan Konfigurasi Auto-Mount (/etc/fstab)
- Stop Service Docker dan Containerd
- Salin Data Lama ke Disk Baru Menggunakan Rsync
- Ubah Konfigurasi Docker Daemon (/etc/docker/daemon.json)
- Ubah Konfigurasi Containerd (/etc/containerd/config.toml)
- Atur Systemd Mount Dependency (Wajib untuk Disk Eksternal)
- Reload Start Ulang Service dan Verifikasi
- Best Practice Migrasi Storage Docker
- Troubleshooting
Kapan Harus Dipindahkan?
Migrasi root directory Docker dan containerd ke partisi atau storage baru sangat disarankan pada kondisi berikut:
- Perangkat dengan eMMC atau SSD Internal Kecil: Misalnya pada server Armbian, Raspberry Pi, atau mini PC yang membutuhkan penyimpanan eksternal (USB flashdisk/NVMe enclosure) sebagai ruang kerja utama container.
- Penambahan Disk Sekunder pada VPS/Bare-Metal: Saat Anda menambahkan block storage baru (seperti
/dev/sdb) khusus untuk menampung beban baca/tulis (I/O workload) aplikasi Docker. - Mengurangi Write Wear pada Storage Utama: Memisahkan aktivitas tulis log dan database container dari partisi sistem operasi utama agar usia pakai chip eMMC/SSD sistem lebih panjang.
Langkah Memindahkan Root Directory Docker & Containerd
Dalam contoh tutorial ini, kita akan memindahkan direktori kerja Docker dan containerd ke partisi baru yang di-mount pada jalur /mnt/usb-fd. Pastikan Anda memiliki akses root atau hak akses sudo.
Siapkan Partisi dan Konfigurasi Auto-Mount (/etc/fstab)
Untuk memastikan /mnt/usb-fd selalu ter-mount sebelum Docker menyala saat booting, daftarkan partisi USB ke /etc/fstab menggunakan UUID dengan opsi defaults,nofail,x-systemd.device-timeout=10, lalu buat file override systemd (sudo systemctl edit docker.service) yang menambahkan directive RequiresMountsFor=/mnt/usb-fd. Kombinasi ini mencegah Docker membuat folder kosong di penyimpanan eMMC internal apabila perangkat USB mengalami keterlambatan deteksi saat cold boot.
Konfigurasi /etc/fstab
Pastikan disk atau partisi baru Anda sudah diformat menggunakan filesystem standar Linux seperti ext4 atau xfs (hindari FAT32/NTFS karena tidak mendukung storage driver overlay2) dan ter-mounting permanen, seperti contoh artikel saya sebelumnya “Mounting Permanen Harddisk atau USB Storage di Linux” lalu buka file /etc/fstab dan tambahkan parameter x-systemd.device-timeout=10 :
UUID=a1b2c3d4-e5f6-7890-abcd-1234567890ef /mnt/usb-fd ext4 defaults,noatime,nofail,x-systemd.device-timeout=10 0 2
Uji konfigurasi fstab tanpa reboot untuk memastikan tidak ada syntax error:
sudo systemctl daemon-reload
sudo mount -a
(Jika perintah sudo mount -a tidak menghasilkan pesan error apa pun dan df -h /mnt/usb-fd menampilkan kapasitas USB Anda, konfigurasi fstab sudah valid).
Stop Service Docker dan Containerd
Sebelum migrasi data, hentikan seluruh service yang terkait agar tidak ada proses transaksi data yang korup:
sudo systemctl stop docker.socket docker.service containerd.service
Salin Data Lama ke Disk Baru Menggunakan Rsync
Buat folder tujuan di dalam partisi baru, lalu salin seluruh data lama beserta atribut owner dan hardlink-nya menggunakan rsync:
sudo mkdir -p /mnt/usb-fd/docker /mnt/usb-fd/containerd
sudo rsync -aHAX /var/lib/docker/ /mnt/usb-fd/docker/
sudo rsync -aHAX /var/lib/containerd/ /mnt/usb-fd/containerd/
Ubah Konfigurasi Docker Daemon (/etc/docker/daemon.json)
Arahkan parameter data-root milik Docker Engine ke direktori baru (sekaligus aktifkan log rotation agar disk baru tetap hemat ruang):
sudo nano /etc/docker/daemon.json
Masukkan konfigurasi berikut:
{
"data-root": "/mnt/usb-fd/docker",
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}
Parameter "data-root": Menetapkan lokasi baru penyimpanan utama Docker Engine menggantikan /var/lib/docker.
Ubah Konfigurasi Containerd (/etc/containerd/config.toml)
Selanjutnya, arahkan root directory milik containerd ke /mnt/usb-fd/containerd:
sudo nano /etc/containerd/config.toml
Cari baris root = "/var/lib/containerd" (atau tambahkan di baris paling atas jika belum terdefinisi) dan ubah menjadi:
root = "/mnt/usb-fd/containerd"
Parameter root: pada config.toml menentukan lokasi penyimpanan snapshotter, content store, dan runtime state containerd.
Atur Systemd Mount Dependency (Wajib untuk Disk Eksternal)
Agar Docker dan containerd tidak running mendahului proses mounting /mnt/usb-fd saat booting, tambahkan override pada kedua service systemd:
sudo systemctl edit docker.service
Tambahkan blok berikut di bagian atas editor:
[Unit]
RequiresMountsFor=/mnt/usb-fd
After=mnt-usb\x2dfd.mount
Lakukan hal yang sama untuk containerd.service:
sudo systemctl edit containerd.service
Masukkan blok konfigurasi yang sama:
[Unit]
RequiresMountsFor=/mnt/usb-fd
After=mnt-usb\x2dfd.mount
Parameter RequiresMountsFor=/mnt/usb-fd: Memaksa systemd untuk memastikan /mnt/usb-fd sudah selesai di-mount sebelum menjalankan service Docker dan Containerd. Jika proses mount gagal atau timeout, Docker akan ditahan agar tidak membuat folder /mnt/usb-fd/docker /mnt/usb-fd/containerd kosong di dalam penyimpanan internal eMMC.
Reload Start Ulang Service dan Verifikasi
Muat ulang konfigurasi systemd, nyalakan kembali containerd dan Docker, lalu periksa direktori aktifnya:
sudo systemctl daemon-reload
sudo systemctl start containerd.service docker.service
docker info --format '{{.DockerRootDir}}'
--format '{{.DockerRootDir}}': Memastikan Docker Engine sudah membaca jalur /mnt/usb-fd/docker.
Jika seluruh container sudah berjalan normal dan tetap aman setelah ditest sudo reboot, hapus direktori lama di penyimpanan internal untuk melegakan kapasitas disk:
sudo rm -rf /var/lib/docker /var/lib/containerd
Best Practice Migrasi Storage Docker
- Backup Direktori Lama Sementara: Jangan langsung menghapus
/var/lib/dockerdan/var/lib/containerdsebelum Anda melakukan pengujian reboot minimal satu kali untuk memastikan urutan mount berjalan lancar. - Gunakan USB 3.0 atau SSD Enclosure: Jika menggunakan penyimpanan eksternal pada SBC, hindari flashdisk murah dengan kecepatan tulis acak (random write) rendah apabila menjalankan database seperti MySQL, PostgreSQL, atau MongoDB di dalam container.
Troubleshooting
- Container Terlihat Hilang Setelah Reboot: Biasanya terjadi karena layanan Docker menyala lebih cepat daripada proses mounting partisi eksternal. Pastikan Anda sudah menerapkan langkah (
RequiresMountsFor=/mnt/usb-fd) padadocker.servicedancontainerd.service. - Error
invalid mount configataudriver not supported: Terjadi apabila partisi tujuan diformat menggunakan NTFS atau exFAT. Format ulang partisi keext4menggunakansudo mkfs.ext4 /dev/sdX1. - Services Docker Gagal Start Setelah Edit
daemon.json: Periksa validitas sintaks JSON (seperti tanda koma yang tertinggal atau berlebih) dengan menjalankan perintahsudo dockerd --validate --config-file=/etc/docker/daemon.json.