Pendahuluan

Matomo adalah aplikasi analitik web yang bersifat open-source dan dihosting sendiri, yang ditulis dalam PHP.

Dalam tutorial ini, Anda akan menginstal Matomo dan database MariaDB menggunakan Docker Compose,

kemudian menginstal Nginx sebagai reverse proxy untuk aplikasi Matomo.

Terakhir, Anda akan mengaktifkan koneksi HTTPS yang aman dengan menggunakan Certbot untuk mengunduh dan mengonfigurasi sertifikat SSL dari Otoritas Sertifikat Let's Encrypt.

Prasyarat

Untuk menyelesaikan tutorial ini, Anda terlebih dahulu memerlukan hal-hal berikut:

• Server Ubuntu 20.04, dengan firewall UFW aktif. Silakan baca tutorial Initial Server Setup with Ubuntu 20.04 untuk mempelajari lebih lanjut tentang pengaturan ini.
• Docker terinstal. Anda dapat mengikuti Step 1 dari How To Install and Use Docker on Ubuntu 20.04 untuk menyelesaikan langkah ini.
• Docker Compose terinstal. Ikuti Step 1 dari How To Install and Use Docker Compose on Ubuntu 20.04 untuk menginstal perangkat lunak ini.

Catatan: Langkah-langkah prasyarat ini dapat dilewati jika Anda menggunakan Gambar Docker One-Click yang disediakan oleh penyedia server Anda.

Untuk mengaktifkan SSL, Anda akan memerlukan nama domain yang mengarah ke alamat IP publik server Anda.

Ini harus berupa sesuatu seperti example.com atau matomo.example.com.

Jika Anda menggunakan server tertentu, lihat panduan DNS Quickstart untuk informasi lebih lanjut tentang cara membuat sumber daya domain.

Langkah Utama

Step 1 — Menjalankan Matomo dan MariaDB dengan Docker Compose

Langkah pertama adalah membuat konfigurasi Docker Compose yang akan meluncurkan kontainer untuk aplikasi Matomo dan database MariaDB.

Tutorial ini akan menempatkan konfigurasi Anda di dalam direktori matomo di direktori home Anda.

Anda juga dapat memilih untuk bekerja di direktori /opt/matomo atau direktori lain sesuai pilihan.

cd ~
mkdir matomo
cd matomo
nano docker-compose.yml

Setelah membuat direktori matomo, buka file YAML kosong bernama docker-compose.yml:

version: "3"
services:
db:
image: mariadb
command: --max-allowed-packet=64MB
restart: always
environment:
MARIADB_DATABASE=matomo
MARIADB_USER
MARIADB_PASSWORD
MARIADB_ROOT_PASSWORD
volumes:
./db:/var/lib/mysql

app:
image: matomo
restart: always
volumes:
./matomo:/var/www/html
ports:
127.0.0.1:8080:80

File ini mendefinisikan dua services, satu db sebagai kontainer MariaDB,

dan satu app yang menjalankan perangkat lunak Matomo.

Kedua layanan juga mengacu pada volume bernama tempat mereka menyimpan beberapa data,

dan layanan app juga membuka port 8080 pada antarmuka loopback (127.0.0.1),

yang akan kita sambungkan melalui localhost.

Simpan file dan keluar dari editor teks Anda untuk melanjutkan.

Di nano, tekan CTRL+O, kemudian ENTER untuk menyimpan,

lalu CTRL+X untuk keluar.

Konfigurasi Lanjutan

Kontainer MariaDB membutuhkan beberapa konfigurasi untuk dioperasikan dengan benar.

Anda harus menetapkan pengguna, kata sandi, dan nama database yang akan digunakan oleh Matomo.

Berikut adalah contoh konfigurasi yang dapat Anda gunakan:

environment:
MARIADB_DATABASE=matomo
MARIADB_USER=matomo_user
MARIADB_PASSWORD=your_password
MARIADB_ROOT_PASSWORD=root_password

Setelah Anda menyimpan file docker-compose.yml, jalankan perintah berikut

untuk meluncurkan kontainer:

docker-compose up -d

Perintah ini akan menjalankan kontainer dalam mode detasemen.

Anda dapat memeriksa status kontainer dengan perintah:

docker ps

Setelah memastikan bahwa kontainer berjalan dengan baik, Anda dapat melanjutkan dengan mengonfigurasi Nginx sebagai reverse proxy untuk Matomo.

Best Practices

Berikut adalah beberapa praktik terbaik yang perlu diingat saat menginstal dan menggunakan Matomo:

• Selalu gunakan kata sandi yang kuat untuk pengguna dan database Anda.
• Perbarui Matomo dan semua dependensinya secara berkala untuk menjaga keamanan sistem Anda.
• Gunakan HTTPS untuk semua koneksi untuk melindungi data pengguna.
• Cadangkan data secara berkala untuk menghindari kehilangan data.
• Monitor penggunaan server dan sumber daya untuk menghindari downtime.

Troubleshooting

Jika Anda mengalami masalah saat menginstal atau menjalankan Matomo, berikut adalah beberapa langkah pemecahan masalah yang dapat dilakukan:

• Periksa status kontainer menggunakan perintah docker ps untuk memastikan bahwa semua kontainer berjalan dengan baik.
• Periksa log kontainer menggunakan perintah docker logs untuk menemukan kesalahan atau masalah lain.
• Pastikan semua variabel lingkungan dalam file docker-compose.yml diatur dengan benar.
• Periksa konfigurasi Nginx untuk memastikan bahwa semua pengaturan dan rute sudah benar.
• Cek port yang digunakan untuk memastikan tidak ada konflik dengan aplikasi lain yang berjalan di server.

Kesimpulan

Dalam tutorial ini, Anda telah belajar cara menginstal Matomo Analytics di Ubuntu 20.04 menggunakan Docker dan Docker Compose.

Dengan mengikuti langkah-langkah di atas, Anda sekarang memiliki sistem analitik yang kuat dan fleksibel untuk situs web Anda.

Pastikan untuk menerapkan praktik terbaik dan melakukan pemeliharaan berkala untuk memastikan bahwa sistem Anda tetap aman dan efektif.