Log adalah tempat kebenaran pertama kali muncul, tapi justru di situ alat kita paling primitif. docker logs cuma bisa satu kontainer per perintah, satu host per terminal, dan begitu salah mengetik filter grep, kita mulai lagi dari awal. Kalau VPS kita menjalankan lima sampai sepuluh kontainer sekaligus — Forgejo, ntfy, Uptime Kuma, n8n, mungkin Traefik — mencari satu baris error di antara semuanya terasa seperti mengais jarum di tumpukan jerami yang terus dipindah. Oke, lanjuutt.. Di artikel ini kita pasang Dozzle di VPS, alat log viewer Docker yang berjalan sebagai satu kontainer, tanpa database, dan menampilkan log semua kontainer dalam satu tab browser.
Sekalian kita bahas bagian yang biasanya dilewati tutorial lain: autentikasi, reverse proxy yang tidak memutus streaming, mode agent untuk beberapa host, dan tiga kegagalan yang paling sering muncul setelah Dozzle terpasang.
Kenapa docker logs Cepat Menyebalkan
Perintah docker logs sendiri tidak salah. Masalahnya ada di bentuknya: satu perintah, satu kontainer, satu host. Begitu kebutuhannya berubah sedikit saja, kita mulai menambal dengan pipa dan alat lain.
- Mengikuti beberapa kontainer sekaligus berarti membuka beberapa terminal, atau menyerah dan menyalin log ke berkas.
- Mencari di seluruh log berakhir dengan
docker logs app 2>&1 | grep error, dan setiap kali pencarian meleset kita mengulang dari awal. - Log JSON dan stack trace datang sebagai dinding teks, padahal yang kita butuh cuma satu baris yang level-nya
error. - Melihat CPU dan memori menuntut jendela
docker statsterpisah, padahal pertanyaannya sering bersamaan: “kenapa log ini muncul dan memorinya naik?” - Host kedua dan ketiga menuntut SSH ke masing-masing mesin, masing-masing dengan terminal sendiri.
Dozzle memangkas semuanya jadi satu halaman: banyak kontainer berdampingan, log bisa digabung antar host, pencarian dan filter level jalan sambil stream tetap mengalir, grafik CPU/memori/network ada di layar yang sama, dan semuanya dibuka lewat browser. Proyek ini berlisensi MIT, ditulis sebagai satu binary Go, dan tidak butuh database — datanya cuma berkas konfigurasi di volume /data.
Versi terbaru saat artikel ini ditulis adalah v11.4.3, rilis 13 November 2026. Tonggak besarnya v11.0.0 pada 11 September 2026: antarmuka digambar ulang hampir seluruhnya, masuk dukungan login GitHub dan OIDC, format log yang dikenali bertambah (termasuk severityText/severityNumber OpenTelemetry dan level numerik Pino), plus satu perubahan yang perlu kita tahu: token sesi berubah, jadi semua pengguna keluar sekali setelah upgrade.
Yang Perlu Ada Sebelum Mulai
Dozzle bukan layanan berat, tapi ada tiga syarat yang jarang disebut:
- Docker Engine 19.03 atau lebih baru (API versi 1.40+). Cek dengan
docker version. - Akses ke socket Docker, yaitu
/var/run/docker.sock. Tanpa ini Dozzle tidak bisa membaca kontainer apa pun. - Ruangan di disk kecil untuk volume
/data, tempat Dozzle menyimpan pengaturan dan daftar pengguna.
Satu peringatan yang harus kita hafal sebelum lanjut: socket Docker setara dengan root di host, dan dokumentasi Dozzle menyebutnya terus terang sebagai root-equivalent access. Siapa pun yang bisa mencapai antarmuka tanpa autentikasi bisa membaca semua log, menghentikan atau menghapus kontainer, bahkan membuat kontainer baru yang memount seluruh berkas host — karena panggilan API tetap lewat socket. Jadi pasang Dozzle di VPS boleh, membiarkannya terbuka ke internet jangan.
Langkah 1: Pasang Dozzle di VPS dengan Docker Compose
Kita mulai dari bentuk paling kecil, satu host, satu kontainer, tanpa autentikasi, hanya di jaringan privat. Simpan berkas compose.yml:
services:
dozzle:
image: amir20/dozzle:latest
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- dozzle_data:/data
ports:
- "127.0.0.1:8080:8080"
environment:
DOZZLE_HOSTNAME: vps-produksi
volumes:
dozzle_data:
Jalankan dengan docker compose up -d, lalu buka http://127.0.0.1:8080 lewat SSH tunnel (ssh -L 8080:127.0.0.1:8080 user@vps). Perhatikan dua detail di berkas itu:
- Port diikat ke
127.0.0.1, bukan0.0.0.0. Ini menutup akses langsung dari internet sebelum autentikasi siap. DOZZLE_HOSTNAMEmemberi nama host yang muncul di header dan menu multi-host. Berguna begitu hostnya lebih dari satu.
Kalau Docker Hub diblokir di jaringan VPS, tarik image dari GitHub Container Registry: ghcr.io/amir20/dozzle:latest. Isinya sama.
Langkah 2: Kunci dengan Autentikasi Sebelum Membuka Port
Dozzle punya dua jalur autentikasi. Kalau kita sudah punya Authelia, Authentik, atau Cloudflare Access, pakai mode forward proxy dan biarkan proxy itu yang memegang pengguna. Kalau belum ada, pakai simple: Dozzle punya halaman login sendiri dan daftar pengguna di users.yml.
Buat berkas penggunanya dengan perintah bawaan, jangan menulis hash bcrypt sendiri:
docker run -it --rm amir20/dozzle generate admin \
--email [email protected] --name "Admin" > users.yml
Tanpa --password, Dozzle akan menanyakan password lewat stdin, jadi password tidak pernah masuk riwayat shell. Simpan users.yml di volume /data, lalu aktifkan provider-nya:
environment:
DOZZLE_AUTH_PROVIDER: simple
DOZZLE_AUTH_TTL: 48h
DOZZLE_AUTH_TTL memperpanjang umur cookie sesi; tanpa itu, cookie habis begitu browser ditutup. Formatnya cuma s, m, atau h — 48h sah, 2d tidak.
Bagian yang sering terlewat adalah roles. Tanpa roles, pengguna baru otomatis dapat all. Kalau kita ingin satu akun hanya boleh membaca log, tulis roles: none; kalau ingin akun kedua boleh membuka shell, tulis roles: shell. Daftar role yang tersedia: shell, actions, update, download, notifications, cloud, all, dan none, dan tiap role bisa dinegasikan dengan awalan ^ — misalnya roles: all,^shell artinya semua kecuali shell.
Satu jebakan yang serius: role notifications dan cloud bersifat instance-wide. Aturan notifikasi mencocokkan kontainer lewat ekspresi, bukan lewat filter pengguna, jadi akun dengan role itu bisa membuat aturan untuk kontainer yang sebenarnya disembunyikan filternya. Berikan hanya ke akun yang kita percaya penuh atas seluruh host.
Actions dan shell mati secara default, dan sebaiknya tetap begitu. Kalau suatu saat butuh, aktifkan sadar-sadar: DOZZLE_ENABLE_ACTIONS=true membuka start, stop, restart, remove, dan update; DOZZLE_ENABLE_SHELL=true membuka shell di dalam kontainer, setara docker exec.
Langkah 3: Taruh di Belakang Reverse Proxy Tanpa Memutus Stream
Di sinilah kebanyakan pemasangan gagal secara halus: halaman terbuka, log muncul beberapa detik, lalu berhenti. Penyebabnya bukan Dozzle, tapi buffering di proxy. Dozzle mengalirkan log lewat Server-Sent Events (SSE), dan proxy yang menahan respons akan mengubah aliran real-time jadi kiriman bertumpuk atau tidak sama sekali.
Untuk Nginx, blok berikut yang bekerja:
location / {
proxy_pass http://127.0.0.1:8080;
chunked_transfer_encoding off;
proxy_buffering off;
proxy_cache off;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
Untuk Caddy, satu baris sudah cukup:
dozzle.contoh.com {
reverse_proxy 127.0.0.1:8080 {
flush_interval -1
}
}
Kalau memakai Traefik, middleware compress bawaan justru yang merusak SSE, jadi text/event-stream harus dikecualikan dari kompresi. Dan kalau Dozzle dipasang di sub-path, pakai DOZZLE_BASE=/dozzle — tapi proxy harus meneruskan path lengkap, bukan memotongnya, kalau tidak halaman akan kosong dan asetnya 404.
Langkah 4: Satu Dozzle untuk Banyak Host lewat Agent
Begitu VPS-nya lebih dari satu, kita tidak perlu memasang antarmuka Dozzle di tiap mesin. Jalankan Dozzle dalam mode agent di host lain; agent hanya membuka port 7007 dan mengirim log ke satu hub.
services:
dozzle-agent:
image: amir20/dozzle:latest
command: agent
volumes:
- /var/run/docker.sock:/var/run/docker.sock
ports:
- "7007:7007"
Di hub, daftarkan agent lewat DOZZLE_REMOTE_AGENT dengan format endpoint|nama|grup, misalnya 10.0.0.5:7007|db-1|Produksi. Format ini yang membuat sidebar punya grup collapsible dan tombol merge all untuk melihat log gabungan seluruh host dalam satu grup.
Dua hal yang wajib dijaga di sini:
- Sertifikat bawaan Dozzle sama di semua salinan image. Koneksi memang terenkripsi TLS, tapi sertifikat itu tidak membuktikan siapa lawan bicaranya. Siapa pun yang bisa mencapai port
7007bisa menyambungkan Dozzle-nya sendiri, membaca semua log host itu, dan menjalankan perintah di dalam kontainernya. Jadi jaga7007di jaringan privat, atau buat sertifikat sendiri supaya agent hanya menerima hub kita. - Actions dan shell hanya hidup kalau hub dan agent dua-duanya mengizinkan. Agent membaca
DOZZLE_ENABLE_ACTIONSdanDOZZLE_ENABLE_SHELLsendiri: kalau tidak diset, dia mengikuti apa yang hub izinkan, tapi kalau disetfalsedia menolak apa pun kata hub. Jadi host yang harus read-only amankan di sisi agent-nya, jangan cuma bergantung pada pengaturan hub.
Kalau Tidak Jalan: Tiga Kegagalan yang Paling Sering
Sebelum kita menganggap Dozzle-nya rusak, periksa tiga hal ini dulu — semuanya berasal dari dokumentasi resmi dan semuanya nyata.
- Log berhenti setelah beberapa detik. Bukan bug Dozzle: proxy menahan respons SSE. Perbaiki
proxy_buffering off(Nginx) atauflush_interval -1(Caddy). Dozzle mengirim headerX-Accel-Buffering: no, tapi sebagian proxy mengabaikannya. - Halaman kosong dan aset 404 saat memakai
--base. Proxy memotong prefiks path sebelum meneruskan. Atur proxy agar path lengkap sampai ke Dozzle. - Agent tidak muncul, log menyebut duplicate host. Dua host memakai Server ID yang sama. Hapus
/var/lib/docker/engine-iddi host yang bermasalah lalu restart; ID baru akan dibuat.
Satu mitos yang perlu dibongkar: mount socket read-only tidak membatasi apa pun. -v /var/run/docker.sock:/var/run/docker.sock:ro hanya menandai berkas socket read-only di disk, sementara panggilan API tetap lewat dan operasi create/delete/update tetap mungkin. Kalau benar-benar ingin membatasi, taruh socket proxy seperti tecnativa/docker-socket-proxy di depan daemon, atau jangan aktifkan actions sama sekali.
Verifikasi: Pastikan yang Terpasang Benar-Benar Bekerja
Setelah semua beres, jangan cuma percaya halaman login yang muncul. Uji empat hal ini:
- Stream hidup: buka log satu kontainer, lalu picu satu baris log (misalnya
docker restartkontainer kecil) dan pastikan barisnya muncul tanpa refresh. - Autentikasi menolak: buka URL di jendela privat, pastikan halaman login muncul, bukan log.
- Port tertutup dari luar:
curl -sI http://IP-VPS:8080harus gagal, karena port kita ikat ke127.0.0.1dan hanya proxy yang mengeksposnya. - Upgrade tidak mengeluarkan kita tanpa alamat: setelah naik dari v10 ke v11, semua sesi putus sekali. Login ulang, lalu cek role pengguna di
users.ymlmasih sesuai.
Kalau keempatnya lolos, kita sudah punya satu tab browser yang menjawab pertanyaan “apa yang sedang terjadi di server ini” tanpa SSH, tanpa grep, dan tanpa membuka lima terminal.
Kesimpulan
Dozzle bukan pengganti monitoring seperti Netdata atau Uptime Kuma — dia menjawab pertanyaan yang berbeda: bukan “apakah server hidup”, tapi “apa yang baru saja dikatakan aplikasinya”. Karena itu pasangan paling masuk akal untuk tumpukan yang sudah kita punya: Uptime Kuma memberi tahu ada yang mati, Dozzle memberi tahu kenapa.
Biayanya nyaris nol: satu kontainer, satu volume kecil, tanpa database, dan lisensi MIT. Yang perlu disiplin justru sisi keamanannya — autentikasi sebelum membuka port, actions dan shell tetap mati, 7007 tetap di jaringan privat. Sisanya, kita bisa berhenti mengais jarum dan mulai membaca log seperti membaca dashboard. Selamat mencoba, dan semoga docker logs kita segera pensiun dengan hormat.

