Fix Colima Error “vz driver is running but host agent is not”
Saat menggunakan Colima untuk menjalankan Docker environment di macOS, kadang kita bisa menemui error yang cukup membingungkan seperti berikut:
➜ ~ colima restart
INFO[0000] stopping colima [profile=default]
INFO[0000] not running context=vm
INFO[0000] done
INFO[0003] starting colima [profile=default]
INFO[0003] runtime: docker
INFO[0004] starting … context=vm
> Using the existing instance “colima-default”
> errors inspecting instance: [vz driver is running but host agent is not]
FATA[0004] error starting vm: error at ‘starting’: exit status 1
Penyebab Masalah
Error berikut:
vz driver is running but host agent is not
menunjukkan bahwa VM yang digunakan oleh Colima (melalui Virtualization.framework / vz driver) berada dalam kondisi tidak konsisten:
- VM dianggap masih berjalan
- Tapi host agent (proses pengontrol) sudah tidak aktif / crash
Kondisi ini biasanya terjadi karena:
- Shutdown yang tidak bersih
- Sleep / hibernate macOS
- Crash pada Colima / Docker runtime
- Interupsi saat start/stop VM
Solusi Cepat
Solusi paling sederhana dan efektif adalah dengan melakukan force stop pada Colima:
colima stop -f
Setelah itu, jalankan kembali:
colima start
Atau jika menggunakan profile:
colima start namaprofile
Kenapa -f (force) Dibutuhkan?
Perintah colima stop biasa akan mencoba menghentikan VM secara graceful.
Namun dalam kasus ini:
- VM state sudah corrupt / tidak sinkron
- Colima tidak bisa berkomunikasi dengan host agent
Sehingga diperlukan:
colima stop -f
yang akan:
- Memaksa terminate VM
- Membersihkan state yang bermasalah
- Reset kondisi instance
Kesimpulan
Error:
vz driver is running but host agent is not
adalah indikasi bahwa VM Colima berada dalam kondisi tidak sinkron.
Solusi paling efektif adalah:
colima stop -f
yang akan memaksa reset VM dan mengembalikan Colima ke kondisi normal.
