Cara Install Umami Web Analytics di Ubuntu 20.04

Umami adalah aplikasi analitik web sumber terbuka yang dihosting sendiri, ditulis dalam Node.js. Aplikasi ini fokus pada kesederhanaan, desain yang baik, kecepatan, dan privasi. Dalam tutorial ini, Anda akan menginstal Umami dan database PostgreSQL menggunakan Docker Compose, kemudian menginstal Nginx sebagai reverse proxy untuk Umami. Akhirnya, Anda akan mengaktifkan koneksi HTTPS yang aman menggunakan Certbot untuk mengunduh dan mengonfigurasi sertifikat SSL dari Let’s Encrypt.

Prasyarat

Sebelum memulai tutorial ini, Anda perlu memastikan bahwa:

• Anda memiliki server Ubuntu 20.04 dengan firewall UFW yang aktif. Bacalah panduan Initial Server Setup with Ubuntu 20.04 untuk lebih lanjut.
• Docker telah terpasang. Anda bisa mengikuti Step 1 dari panduan ini.
• Docker Compose telah terpasang. Anda bisa mengikuti Step 1 dari panduan ini.

Catatan: Langkah prasyarat ini dapat dilewati jika Anda menggunakan gambar Docker 1-Click dari penyedia layanan.

Untuk mengaktifkan SSL, Anda memerlukan nama domain yang mengarah ke alamat IP publik server Anda, seperti example.com atau umami.example.com.

Langkah Utama

Langkah 1 — Menginstal Umami dan PostgreSQL dengan Docker Compose

Langkah pertama adalah mengkloning repositori Umami, memperbarui file konfigurasi docker-compose.yml, dan kemudian memulai kontainer Umami dan PostgreSQL.

cd /opt

Gunakan perintah git untuk mengkloning repositori dari GitHub:

sudo git clone https://github.com/mikecao/umami.git

Ini akan mengunduh semua file perangkat lunak dan konfigurasi ke dalam /opt/umami. Pindah ke direktori umami yang baru dibuat:

cd umami

Sekarang, Anda perlu memperbarui file docker-compose.yml. File ini digunakan oleh perintah docker-compose untuk mengonfigurasi dan memulai beberapa kontainer Docker sekaligus. Kita perlu mengubah dua opsi di file ini: IP yang Umami ikat dan hash acak yang digunakan sebagai garam saat mengenkripsi data dalam database.

Sebelum Anda membuka docker-compose.yml untuk mengedit, mari kita menghasilkan hash acak baru untuk disalin ke dalam file:

openssl rand -base64 32

Output: tCgKyCWc/3C9VH+Ex0TysXsGEKQklQXm0H3nSnlR48g=

Salin keluaran ke clipboard Anda, lalu buka file konfigurasi:

sudo nano docker-compose.yml

Cari opsi HASH_SALT, hapus teks placeholder, dan tempelkan hash acak yang baru saja Anda hasilkan:

HASH_SALT: replace-me-with-a-random-string

Selanjutnya, cari bagian ports: dalam konfigurasi:

ports:
"3000:3000"

Ini berarti port 3000 pada host akan diarahkan ke port 3000 dalam kontainer. Anda dapat mengubah port ini sesuai kebutuhan, tetapi pastikan bahwa port yang Anda pilih tidak digunakan oleh layanan lain.

Setelah Anda selesai mengedit, simpan dan keluar dari editor.

Langkah 2 — Menjalankan Umami dan PostgreSQL

Setelah file konfigurasi diperbarui, jalankan perintah berikut untuk memulai kontainer:

sudo docker-compose up -d

Perintah ini akan menjalankan semua layanan yang didefinisikan dalam docker-compose.yml di background.

Langkah 3 — Memastikan Kontainer Berjalan

Verifikasi bahwa kontainer Umami dan PostgreSQL berjalan dengan perintah:

sudo docker ps

Jika Anda melihat kontainer umami dan postgres dalam daftar, maka Anda berhasil menginstal aplikasi.

Konfigurasi Lanjutan

Anda dapat menyesuaikan lebih lanjut aplikasi Umami sesuai kebutuhan Anda. Misalnya, Anda bisa mengatur lebih banyak variabel lingkungan dalam file docker-compose.yml untuk meningkatkan keamanan dan fungsionalitas.

Jangan lupa untuk mengonfigurasi Nginx sebagai reverse proxy agar layanan Anda bisa diakses melalui HTTP/HTTPS. Anda bisa menginstal Nginx dengan perintah berikut:

sudo apt install nginx

Setelah instalasi, buat file konfigurasi baru di dalam folder /etc/nginx/sites-available/ dan aktifkan dengan membuat symlink ke /etc/nginx/sites-enabled/.

Best Practices

• Selalu perbarui sistem dan aplikasi Anda untuk menjaga keamanan.
• Gunakan firewall untuk membatasi akses ke server Anda.
• Periksa log secara berkala untuk mendeteksi aktivitas mencurigakan.
• Cadangkan data secara teratur untuk menghindari kehilangan informasi berharga.
• Gunakan HTTPS untuk melindungi data yang ditransmisikan antara server dan klien.

Troubleshooting

Jika Anda mengalami masalah saat menjalankan Umami, berikut adalah beberapa langkah pemecahan masalah yang dapat membantu:

• Periksa log kontainer dengan perintah sudo docker logs untuk mendapatkan informasi lebih lanjut tentang kesalahan yang terjadi.
• Pastikan semua port yang diperlukan terbuka dan tidak diblokir oleh firewall.
• Verifikasi bahwa database PostgreSQL berjalan dengan baik dan dapat diakses oleh Umami.
• Periksa apakah semua variabel lingkungan ditetapkan dengan benar dalam file docker-compose.yml.

Kesimpulan

Dalam tutorial ini, Anda telah berhasil menginstal Umami Web Analytics di Ubuntu 20.04 menggunakan Docker dan PostgreSQL. Anda sekarang memiliki alat analitik web yang kuat untuk memantau pengunjung situs web Anda dengan privasi dan efisiensi. Pastikan untuk menerapkan praktik terbaik dan memecahkan masalah yang mungkin muncul saat menjalankan aplikasi Anda.

Selamat mencoba dan terus eksplorasi fitur-fitur yang ditawarkan oleh Umami!