Cara Lihat Log Aplikasi Docker di CasaOS untuk Pemula

Aplikasi di CasaOS tiba-tiba error, lambat, atau tidak bisa diakses — dan kamu tidak tahu kenapa? Jawabannya hampir selalu ada di log aplikasi.

Log adalah catatan aktivitas yang ditulis oleh aplikasi secara otomatis: mulai dari proses startup, aktivitas normal, peringatan, hingga pesan error yang bisa menunjukkan tepat di mana masalahnya terjadi. Bagi pengguna homelab, kemampuan membaca log adalah skill paling penting yang wajib dikuasai.

Artikel ini membahas cara melihat log aplikasi Docker di CasaOS — mulai dari cara termudah via GUI, hingga perintah terminal yang lebih powerful.

Cara 1: Lihat Log via CasaOS GUI

#

CasaOS menyediakan akses log langsung dari dashboard tanpa perlu membuka terminal.

Langkah-langkahnya:

#

1. Buka CasaOS Dashboard di browser.
2. Klik pada ikon aplikasi yang ingin dilihat lognya.
3. Di panel yang muncul, cari tab atau tombol “Logs”.
4. Log akan ditampilkan di layar secara langsung.

Kelebihan cara ini:

• Mudah dan cepat tanpa perlu terminal
• Cocok untuk melihat log singkat atau mendeteksi error yang baru terjadi

Kekurangannya:

• Tampilan terbatas, tidak bisa filter atau search
• Ada bug di beberapa versi CasaOS di mana karakter tertentu seperti <> tidak tampil dengan benar
• Tidak cocok untuk analisis log yang panjang

Untuk analisis yang lebih dalam, gunakan terminal.

Cara 2: Lihat Log via Terminal (Lebih Powerful)

#

Perintah dasar: tampilkan semua log

#

docker logs nama-container

Ganti nama-container dengan nama aplikasimu. Tidak tahu nama containernya? Cek dengan:

docker ps

Contoh penggunaan:

docker logs jellyfin
docker logs nextcloud
docker logs vaultwarden

Tampilkan hanya N baris terakhir (paling sering dipakai)

#

Untuk log yang sangat panjang, tampilkan hanya bagian akhirnya saja:

docker logs nama-container --tail 50

Angka 50 berarti 50 baris terakhir. Sesuaikan dengan kebutuhan — misalnya 100, 200, atau 500.

Ikuti log secara real-time (live monitoring)

#

Untuk memantau log yang sedang berjalan secara langsung — sangat berguna saat debugging:

docker logs nama-container -f

Flag -f berarti follow — log akan terus bertambah di layar seiring aktivitas aplikasi. Tekan Ctrl + C untuk berhenti.

Kombinasi yang paling sering dipakai:

docker logs nama-container -f --tail 20

Ini menampilkan 20 baris terakhir, lalu terus memantau log baru secara real-time.

Tampilkan log dengan timestamp

#

Sangat berguna untuk mengetahui kapan persis suatu event terjadi:

docker logs nama-container --timestamps

Contoh output:

2026-03-27T08:15:32.123Z [INFO] Server started on port 8096
2026-03-27T08:15:33.456Z [INFO] Database connection established
2026-03-27T08:20:11.789Z [ERROR] Failed to read file: permission denied

Filter log berdasarkan waktu

#

Lihat log dari 1 jam terakhir:

docker logs nama-container --since 1h

Lihat log dari 30 menit terakhir:

docker logs nama-container --since 30m

Lihat log dalam rentang waktu tertentu:

docker logs nama-container --since "2026-03-27T08:00:00" --until "2026-03-27T09:00:00"

Cari pesan error secara spesifik

#

Kombinasikan docker logs dengan grep untuk mencari kata kunci tertentu:

# Cari semua baris yang mengandung kata "error"
docker logs nama-container 2>&1 | grep -i "error"
 
# Cari "error" atau "warning" sekaligus
docker logs nama-container 2>&1 | grep -iE "error|warning|fatal"
 
# Cari "timeout" beserta 5 baris konteks di sekitarnya
docker logs nama-container 2>&1 | grep -A 5 -B 5 "timeout"

💡 Mengapa ada 2>&1? Karena Docker menulis sebagian log ke stderr (STDERR), bukan stdout (STDOUT). Dengan 2>&1, kita menggabungkan keduanya sehingga grep bisa mencari di seluruh output.

Simpan log ke file

#

Untuk analisis offline atau dikirim ke orang lain:

docker logs nama-container > log-aplikasi.txt
 
# Simpan log dari 24 jam terakhir
docker logs nama-container --since 24h > log-24jam.txt
 
# Simpan sambil tetap menampilkan di layar
docker logs nama-container 2>&1 | tee log-aplikasi.txt

Cara Membaca Log: Panduan Pemula

#

Log bisa terasa overwhelming pada awalnya. Berikut panduan singkat membacanya:

Kenali level log yang umum

#

Fokus pada bagian yang tepat

#

Saat troubleshooting, jangan baca dari atas. Mulai dari bawah (log paling baru) dan cari baris dengan kata kunci ERROR atau FATAL. Baris-baris sebelum error tersebut biasanya menunjukkan konteksnya.

Contoh log error umum dan artinya

#

# Permission denied — folder tidak bisa diakses
[ERROR] open /config/data.db: permission denied
→ Solusi: sudo chown -R 1000:1000 /DATA/AppData/nama-app
 
# Port sudah dipakai
[ERROR] bind: address already in use
→ Solusi: ganti port aplikasi atau stop aplikasi lain yang pakai port sama
 
# Kehabisan storage
[ERROR] write /data/cache: no space left on device
→ Solusi: docker system prune, hapus file yang tidak perlu
 
# Gagal koneksi database
[ERROR] failed to connect to database: connection refused
→ Solusi: pastikan container database (misalnya MariaDB/PostgreSQL) berjalan

Log Container yang Sudah Berhenti (Crash)

#

Salah satu keunggulan Docker adalah log tetap tersimpan bahkan setelah container crash atau berhenti. Ini sangat membantu saat debugging.

# Lihat container yang sudah berhenti
docker ps -a
 
# Ambil log dari container yang sudah exit
docker logs nama-container-yang-crash --tail 100

⚠️ Log akan hilang permanen jika container dihapus dengan docker rm. Selalu cek log sebelum menghapus container yang bermasalah.

Cek Log CasaOS itu Sendiri

#

Selain log aplikasi, kamu juga bisa cek log sistem CasaOS jika dashboard atau fitur tertentu bermasalah:

# Log service utama CasaOS
sudo journalctl -u casaos -f
 
# Log gateway CasaOS
sudo journalctl -u casaos-gateway -f
 
# Log app management
sudo journalctl -u casaos-app-management -f

Kesimpulan

#

Melihat log aplikasi Docker di CasaOS adalah skill fundamental yang akan sangat membantu saat ada masalah. Mulai dari cara termudah via GUI, hingga perintah terminal yang fleksibel seperti:

• docker logs nama-container — lihat semua log
• docker logs nama-container -f --tail 50 — monitor real-time
• docker logs nama-container 2>&1 | grep -i error — cari error spesifik

Jadikan kebiasaan untuk selalu cek log sebelum mencari solusi di forum atau internet — seringkali jawabannya sudah ada langsung di log aplikasimu.

Referensi: Docker Docs — Logging | Docker Logs Command Reference