Halo, Sob! Plausible merupakan alat analitik web yang ramah privasi dan ringan, dirancang untuk memberikan wawasan yang jelas tanpa mengorbankan privasi pengguna. Dengan menggunakan Plausible Analytics di Docker Compose pada hosting Ubuntu, kamu dapat dengan mudah menginstal dan mengelola aplikasi analitik web yang efisien dan hemat sumber daya. Karena Plausible dirancang dengan fokus pada kecepatan dan minimalisme. Dibandingkan dengan alat analitik web tradisional lainnya, Plausible menggunakan lebih sedikit memori dan CPU, sehingga cocok untuk digunakan di server dengan spesifikasi rendah. Selain itu, Plausible hanya mengumpulkan data yang relevan, mengurangi beban pada server dan meminimalkan penggunaan bandwidth. Hal ini membuat Plausible menjadi pilihan ideal bagi pengelola situs yang mengutamakan performa dan privasi pengguna, tanpa harus mengorbankan kemampuan analitik. Sehingga kombinasi ketiganya kamu bisa mengoptimalkan penggunaan Plausible untuk situs web kamu.
Artikel kali ini akan membahas cara instalasi Plausible Analytics di VPS Ubuntu 22.04 menggunakan Docker Compose.
Prasyarat
- Memiliki hosting VPS Ubuntu aktif
- Sudah terinstal Docker dan Docker Composer di Ubuntu
Step 1: Buat Koneksi SSH VPS
Pertama, buat koneksi SSH ke VPS kamu melalui terminal. Jika menggunakan sistem operasi Windows, kamu bisa menggunakan PuTTY.
Detail informasi awal layanan kamu bisa diakses pada Informasi Awal Layanan VM.
Step 2: Download Nginx dari Docker Hub
Masuk ke direktori /opt, yang nanti akan digunakan untuk menginstal aplikasi tambahan secara manual.
cd /opt
Kemudian clone repo GutHub.
sudo git clone https://github.com/plausible/hosting plausible
Lalu, masuk ke direktori hasil clone.
cd plausible
Buat secret key yang akan digunakan sebagai SECRET_KEY_BASE dan jangan lupa salin kodenya dan letakkan di text editor seperti notepad atau lainnya.
openssl rand 64 | base64 -w 0 ; echo
Selanjutnya, edit file konfigurasi plausible-conf.env. Buka file konfigurasinya dulu.
sudo nano plausible-conf.env
Isikan script berikut di dalamnya:
ADMIN_USER_EMAIL=your_email_here
ADMIN_USER_NAME=admin_username
ADMIN_USER_PWD=admin_password
BASE_URL=https//yourdomain
SECRET_KEY_BASE=paste_your_random_characters_here
Penjelasan:
- Gunakan email dan password aktif.
- Ganti domain sesuai domain kamu.
- Jika menggunakan domain saja, ganti https:// menjadi http://
Jika selesai, tekan CTRL+X, Y lalu Enter untuk menyimpan dan keluar dari editor.
Berikutnya edit file compose.yml
sudo nano compose.yml
Kemudian tambahkan file .env dan ports agar dikenali.
env_file:
- plausible-conf.env
ports:
- “8000:8000”
Simpan file, CTRL+X, Y lalu Enter untuk keluar dari mode editor.
Lalu, jalankan container dengan Docker Compose.
sudo docker compose up --detach
Kemudian lihat apakah container sudah berjalan
sudo docker compose ps
Outpunya harus seperti:
running 0.0.0.0:8000->8000/tcp, :::8000->8000/tcp
plausible-plausible_db-1 "docker-entrypoint.s…" plausible_db running (healthy) 5432/tcp
plausible-plausible_events_db-1 "/entrypoint.sh" plausible_events_db running (healthy) 9009/tcp
Step 3: Install dan Konfigurasi Nginx
Kembali ke path root.
cd
Update package sistem dan install Nginx.
sudo apt update
sudo apt install nginx
Beri izin akses untuk service HTTP dan HTTPS di firewall.
sudo ufw allow "Nginx Full"
Kemudian, buat file konfigurasi Nginx untuk Plausible.
sudo nano /etc/nginx/sites-available/plausible.conf
Isi konfigurasi berikut ini, lalu ganti your_domain_here dengan ip-vps-kamu atau kamu bisa pakai nama domain kamu.
server {
listen 80;
listen [::]:80;
server_name 10.0.0.0;
access_log /var/log/nginx/plausible.access.log;
error_log /var/log/nginx/plausible.error.log;
location / {
proxy_pass http://localhost:8000;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
Jangan lupa ganti server_name. Kalau kamu pakai domain, isi dengan server_name domainkamu.com;
Selanjutnya, aktifkan konfigurasi.
sudo ln -s /etc/nginx/sites-available/plausible.conf /etc/nginx/sites-enabled/
Periksa konfigurasi Nginx.
sudo nginx -t
Outputnya harus:
nginx: configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
Restart server Nginx:
sudo systemctl reload nginx
Step 4: Install Certbot dan Setting Sertifikat SSL
Instal, Certbot dan Nginx plugin:
sudo apt install certbot python3-certbot-nginx
Kemudian, jalankan certbot in –nginx dan masukkan domain yang kamu daftarkan SSL.
sudo certbot --nginx -d your_domain_here
Akan muncul pesan pada prompt yang meminta kamu untuk mengisikan email aktif untuk mendapatkan informasi terkait SSL kamu, lalu tekan Y saja kalau muncul konfirmasi persetujuan.
Setelah itu, Let’s Encrypt akan mengkonfirmasi permintaan dan Certbot akan mendownload sertifikat kamu. Seperti ini hasilnya kalau berhasil request sertifikat.
Step 5: Buka Situs Plausible
Setelah semua konfigurasi dilakukan, buka situs Plausible dengan url http://ip-server-kamu atau https://domainkamu.com
Troubleshooting
Kalau kamu mengalami error bad gate way 502 pada halaman website Plausible dan atau menjumpai pesan warning seperti berikut.
WARN[0000] The “BASE_URL” variable is not set. Defaulting to a blank string.
WARN[0000] The “SECRET_KEY_BASE” variable is not set. Defaulting to a blank string.
…
Runtime terminating during boot ({#{message=><<“BASE_URL must start with `http` or `https`. Currently configured as “”>>})
Periksa dulu di compose.yml dan plausible-conf.env sudah ditulis dengan benar. Setelah mengoreksi jalankan ulang docker.
sudo docker compose down -v
sudo docker compose up build --detach
Kemudian cek status container.
sudo docker compose ps
Kalau plausible_1 masih restarting, langsung lihat log. Nanti bisa tahu apa masalahnya.
sudo docker compose logs -f plausible
Kalau outputnya seperti di bawah ini, walaupun kamu sudah menul base_url dan secret_key_base di compose.yml dengan benar.
** (RuntimeError) BASE_URL must start with `http` or `https`. Currently configured as “
Besar kemungkinan karena base url tidak terbaca. Untuk memastikannya coba jalankan command:
docker compose config
Cari bagian environment: dari service plausible, dan pastikan ada: BASE_URL domain kamu. Kalau kosong atau tidak muncul berarti konfigurasi plausible-conf.env tidak terbaca.
Cara mengatasinya dengan mendefinisikan kedua variabel tersebut secara langsung di dalam compose.yml. Jadinya seperti ini:
Lalu jalankan ulang:
docker compose down -v
docker compose up --build -d
docker compose logs -f plausible
Tunggu sampai Docker mengenali konfigurasi kamu. Kalau sudah coba refresh domain kamu. Atau untuk memeriksanya benar-benar dapat berkerja (status plausible_1 running), jalankan:
docker compose ps
Gimana, Sob? Apakah situs Plausible kamu berhasil diakses? Memang cukup kompleks, apalagi bagi kaum pemula yang baru berkerja dengan Docker. Tapi, jangan menyerah, Sob teruslah eksplor supaya menjadi mahir. Setelah berhasil, kamu mulai bisa set up databasenya agar bisa melakukan aktivitas di dalam Plausible.
Kalau ada yang masih bingung kamu bisa hubungi Tim Support Jagoan Hosting via Live Chat atau Open Ticket ya, Sob!