Cara Install Chatwoot di Server Docker Mudah (7 Langkah)

Kenapa Pilih Chatwoot untuk Dukungan Customer Support?

Chatwoot adalah platform untuk customer support berbasis open-source dengan fitur omni-channel yang memungkinkan percakapan dari berbagai saluran tergabung jadi satu.

Daripada aplikasi lainnya, Chatwoot juga fleksibel dan menyediakan opsi deployment secara self-host di server pribadi atau cloud hosting.

Namun kebanyakan pengguna memilih deploy di server pribadi, karena pengguna bisa memiliki kontrol penuh terhadap server.

Syarat Install Chatwoot

Jika Sobat berencana install Chatwoot VPS atau server lainnya, pastikan catat dulu syarat yang diperlukan agar instalasi lancar. Adapun syaratnya yaitu:

1. Syarat Minimum Perangkat

• CPU: 2 cores
• RAM: 4GB
• Storage: 20GB SSD
• OS: Ubuntu 20.04+ atau Linux

2. Syarat Teknis

• Nama domain
• Server yang memenuhi syarat minimum
• Sertifikat SSL
• Server SMTP (jika ingin notifikasi email)

3. Syarat Akses

• Akses SSH ke server
• Akses root atau sudo
• Akses untuk konfigurasi firewall

4. Syarat Opsional tetapi Disarankan

• Penyimpanan objek (AWS S3, Google Cloud Storage, dll.)
• CDN (jika memiliki aset statis)
• Alat monitoring (misalnya APM dan logging)
• Backup

Cara Install Chatwoot di Server

Karena akan menginstal di server, maka deployment akan menggunakan Docker. Kenapa Docker?

Dengan Docker, performanya lebih maksimal dan stabil. Alternatinya, kamu bisa melakukan deployment dengan Kubernetes dan Linux VM.

Kalau sudah memahaminya, mari ikuti cara install Chatwoot Docker:

1. Cek Versi Docker yang Kamu Gunakan

Cek apakah kamu sudah menggunakan versi terbaru dari Docker dan Docker Compose. Caranya gunakan skrip berikut:

#cek versi docker

Docker version 20.10.10, build b485636

#cek versi docker compose

Docker Compose version v2.14.1

Jika masih menggunakan versi lama, segera update ke versi terbaru.

2. Instal Docker di Server (VM)

Selanjutnya, instal Docker pada server berbasis Ubuntu. Gunakan perintah berikut:

#Update dan upgrade paket

apt-get update

apt-get upgrade

#Download dan instal Docker

curl -fsSL https://get.docker.com -o get-docker.sh

sudo sh get-docker.sh

#Instal Docker compose plugin

apt install docker-compose-plugin

3. Unduh File yang Diperlukan

Jika Docker berhasil terinstal, selanjutnya kamu perlu mengunduh file konfigurasi yang dibutuhkan:

#Unduh template file .env

wget -O .env https://raw.githubusercontent.com/chatwoot/chatwoot/develop/.env.example

#Unduh template file docker-compose.yaml

wget -O docker-compose.yaml https://raw.githubusercontent.com/chatwoot/chatwoot/develop/docker-compose.production.yaml

4. Konfigurasi Variabel Lingkungan

Masing-masing file yang sudah terunduh perlu disesuaikan lagi. Buka file .env dan docker-compose.yaml, tergantung kebutuhan.

Misalnya, kamu bisa memperbarui password untuk Redis dan PostgreSQL, atau menggunakan layanan provider untuk database dengan mengonfigurasi variabel lingkungan.

#Update password Redis dan PostgreSQL di file .env

nano .env

#Update password di docker-compose.yaml

nano docker-compose.yaml

5. Siapkan Database

Kemudian, siapkan database Chatwoot dengan menggunakan perintah berikut:

docker compose run --rm rails bundle exec rails db:chatwoot_prepare

6. Jalankan Layanan

Jalankan Chatwoot di background dengan menggunakan Docker Compose:

docker compose up -d

Untuk memverifikasi apakah instalasi berjalan dengan baik, periksa dengan perintah:

curl -I localhost:3000/api

Jika instalasi berhasil, kamu akan menerima response dengan status 200.

7. Akses Instalasi Chatwoot

Sampai sini, langkah-langkah Install Chatwoot selesai. Namun, container yang berjalan hanya bisa diakses melalui localhost dan tidak terhubung ke internet.

Kalau ingin mengaksesnya secara publik, kamu perlu mengkonfigurasi reverse proxy, seperti Nginx.

Cara Konfigurasi Chatwoot dengan Nginx dan SSL

Berikut langkah-langkah untuk mengkonfigurasi Chatwoot Docker menggunakan Nginx sebagai reverse proxy dan mengamankan dengan SSL dari Let’s Encrypt.

1. Instal Nginx

Instalasi Nginx bertujuan sebagai frontend proxy Chatwoot. Gunakan kode:

sudo apt-get install nginx

cd /etc/nginx/sites-enabled

nano yourdomain.com.conf

2. Konfigurasi Nginx

Selanjutnya, masukkan konfigurasi berikut pada file yourdomain.com.conf. Ganti yourdomain.com dengan nama domain milikmu.

server {

  server_name <yourdomain.com>;

  # Point upstream ke Chatwoot App Server

  set $upstream 127.0.0.1:3000;

  # Nginx menghilangkan underscore di headers secara default

  underscores_in_headers on;

  location /.well-known {

alias /var/www/ssl-proof/chatwoot/.well-known;

  }

  location / {

    proxy_pass_header Authorization;

    proxy_pass http://$upstream;

    proxy_set_header Upgrade $http_upgrade;

    proxy_set_header Connection "upgrade";

    proxy_set_header Host $host;

    proxy_set_header X-Forwarded-Proto $scheme;

    proxy_set_header X-Forwarded-Ssl on; # Opsional

proxy_set_header X-Real-IP $remote_addr;

    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

    proxy_http_version 1.1;

    proxy_buffering off;

    client_max_body_size 0;

    proxy_read_timeout 36000s;

    proxy_redirect off;

  }

  listen 80;

}

3. Cek Konfigurasi Nginx

Cek konfigurasi Nginx, lalu reload untuk memastikannya:

nginx -t

systemctl reload nginx

4. Instal dan Konfigurasi SSL dengan Let’s Encrypt

Berikunya, install Certbot untuk SSL dan konfigurasikan sertifikat tersebut dengan perintah:

apt install certbot

apt-get install python3-certbot-nginx

mkdir -p /var/www/ssl-proof/chatwoot/.well-known

certbot --webroot -w /var/www/ssl-proof/chatwoot/ -d yourdomain.com -i nginx

5. Akses Chatwoot

Install Chatwoot sudah selesai. Kini kamu bisa mengakses Chatwoot melalui HTTPS di https://yourdomain.com.

Masalah Umum Saat Install Chatwoot dan Solusinya

Jika ini pertama kalinya kamu menginstal Chatwoot manual, mungkin kamu akan menghadapi sejumlah masalah.

Tenang, berikut kami sajikan beberapa masalah umum yang sering terjadi saat instal Chatwoot self hosted, beserta solusinya agar instalasi tidak terkendala:

1. Bundler Cannot Continue

Pesan eror seperti “An error occurred while installing pg (1.5.4), and Bundler cannot continue. Make sure that `gem install pg -v ‘1.5.4’` succeeds before bundling”, biasanya dikarenakan hilangnya header PostgreSQL atau jalur pg_config yang tidak benar.

Solusinya:

• macOS: Install PostgreSQL dengan Homebrew dan pastikan pg_config terdeteksi.

brew install postgresql

bundle config build.pg --with-pg-config=/opt/homebrew/bin/pg_config  # Untuk M1 Mac

# atau jika menggunakan Intel Mac

bundle config build.pg --with-pg-config=/usr/local/bin/pg_config

bundle install

• Ubuntu/Debian: Install PostgreSQL development headers.

sudo apt-get install libpq-dev

bundle install

• CentOS/RHEL: Install PostgreSQL development headers.

sudo yum install postgresql-devel

bundle install

2. Node.js and Package Manager Issues

Pesan eror seperti “error @chatwoot/[email protected]: The engine “node” is incompatible with this module”.

Solusinya:

• nvm (Node Version Manager): Install dan gunakan versi Node.js yang benar (versi 20).

nvm install 20

nvm use 20

nvm alias default 20

node --version  # Verifikasi versi

• n: Install Node.js versi 20 menggunakan perintah berikut.

sudo n 20

• asdf: Install dan atur Node.js versi 20 menggunakan asdf.

asdf install nodejs 20

asdf global nodejs 20

3. Redis Connection Issues

Biasanya tampil pesan eror “Redis::CannotConnectError: Error connecting to Redis on localhost:6379”

Solusinya:

• macOS

brew services list | grep redis  # Periksa status Redis

brew services start redis    # Mulai Redis jika belum berjalan

redis-cli ping               # Uji koneksi Redis

• Ubuntu/Debian

systemctl status redis      

sudo systemctl start redis

redis-cli ping             

• Docker

docker ps | grep redis      

docker run --name redis -d redis 

redis-cli ping            

4. Masalah Pengiriman Email

Jika email tidak terkirim di lingkungan pengembangan, kemungkinan masalahnya ada pada konfigurasi SMTP atau layanan email.

Solusinya:

• macOS: Gunakan MailHog dengan perintah brew install mailhog dan menjalankan mailhog.

[email protected]

SMTP_ADDRESS=localhost

SMTP_PORT=1025

Setelah itu, buka antarmuka web MailHog di http://localhost:8025 untuk melihat email yang terkirim.

• Gmail SMTP: Konfigurasikan file .env

[email protected]
SMTP_ADDRESS=smtp.gmail.com
SMTP_PORT=587
[email protected]
SMTP_PASSWORD=your-email-password

• Letter Opener

Pastikan pengaturan config.action_mailer.delivery_method diatur ke :letter_opener di file konfigurasi Rails Anda.

5. Masalah Debugging dan Logging

Jika log file terlalu besar, coba bersihkan log dengan perintah

> log/development.log dan > log/test.log

 Untuk mencegah masalah ini terjadi lagi, atur konfigurasi rotasi log di file development.rb dengan menambahkan baris berikut:

config.logger = ActiveSupport::Logger.new(“log/development.log”, 5, 10.megabytes)

FAQ seputar Install Chatwoot

Apakah perlu keahlian untuk menginstal Chatwoot?

Ya, kamu harus memahami cara kerja server dan hal teknis lainnya. Jika tidak memiliki pengalaman teknis, pertimbangkan gunakan layanan pre-installed seperti yang disediakan Jagoan Hosting.

Di mana bisa menginstal Chatwoot?

Kamu bisa menginstalnya di server pribadi atau cloud hosting. Syarat dan prosedur instalasinya berbeda.

Bisakah menginstal Chatwoot di server biasa?

Ya, bisa. Namun lebih baik gunakan server khusus untuk Chatwoot, seperti server VPS atau dedicated server agar performanya maksimal.

Repot Install Chatwoot Manual? Pakai Chatwoot Siap Pakai dari Jagoan Hosting

Sekarang, kamu tak perlu ribet install Chatwoot dari nol yang rentan kesalahan, apalagi kalau ini pertama kalinya kamu coba instal manual.

Lebih baik pakai Chatwoot VPS murah pre-installed dari Jagoan Hosting, siap pakai untuk mendukung customer support bisnismu.

Kenapa pilih Chatwoot Pre-installed dari Jagoan Hosting?

• Server VPS dengan sumber daya bebas atur
• Docker-based yang yang stabil
• Gratis SSL dan domain .cloud
• Uptime jaringan dan server 99.9%
• Storage hingga 200GB dan RAM hingga 32GB

Selain itu, kamu akan mendapatkan dukungan 24/7 via WhatsApp dari tim support kami yang tersertifikasi, jika ada masalah.

Masih punya banyak pertanyaan? Chat WhatsApp kami untuk konsultasi gratis sekarang!