Skip to main content

Production deployment guide for Linux VM

Deploying to Linux VM#

This guide will help you to install Chatwoot on Ubuntu 20.04 LTS / 20.10. We have prepared a deployment script for you to run. Refer to the script and feel free to make changes accordingly to OS if you are on a non-Ubuntu system.

Steps to install#

Note: If you plan to use a domain with chatwoot, please add an A record before proceeding. Refer the Configuring the installation domain section below.

  1. Create a setup.sh file and copy the content from the above link or use the following commands.
wget https://raw.githubusercontent.com/chatwoot/chatwoot/master/deployment/setup_20.04.sh -O setup.shchmod 755 setup.sh
  1. Execute the script, and it will take care of the initial Chatwoot setup.
./setup.sh master
  1. Chatwoot Installation will now be accessible at http://{your_ip_address}:3000 or if you opted for domain setup, it will be at https://chatwoot.mydomain.com.

Note: If you are running the script on Ubuntu VM on AWS EC2, make sure that you are logged in as root user not as the ubuntu user.

Configuring The installation Domain#

  1. Create an A record for chatwoot.mydomain.com on your domain management system and point it towards the installation IP address.
  2. Continue with the installation script by entering yes when prompted about domain setup.
  3. Enter your domain, and the script will take care of configuring Nginx and SSL via LetsEncrypt.
  4. Your Chatwoot installation should be accessible from https://chatwoot.mydomain.com now.

Configure the required environment variables#

For your Chatwoot installation to properly function, you would need to configure the essential environment variables like FRONTEND_URL, Mailer and a cloud storage config. Refer Environment variables for the full list.

  1. Login as Chatwoot and edit the .env file.
# Login as chatwoot user
sudo -i -u chatwootcd chatwootnano .env
  1. Refer Environment variables and update the required variables. Save the .env file.

  2. Restart the Chatwoot server and enjoy using your self hosted Chatwoot.

systemctl restart chatwoot.target

Upgrading to a newer version of Chatwoot#

Whenever a new version of Chatwoot is released, use the following steps to upgrade your instance.

Run the following steps on your VM. Make changes based o your OS if you are on a non-Ubuntu system.

# Login as Chatwoot usersudo -i -u chatwoot
# Navigate to the Chatwoot directorycd chatwoot
# Pull the latest version of the master branchgit checkout master && git pull
# Ensure the ruby version is upto datervm install "ruby-3.0.2"rvm use 3.0.2 --default
# Update dependenciesbundleyarn
# Recompile the assetsrake assets:precompile RAILS_ENV=production
# Migrate the database schemaRAILS_ENV=production bundle exec rake db:migrate
# Switch back to root userexit
# Copy the updated targetscp /home/chatwoot/chatwoot/deployment/chatwoot-web.1.service /etc/systemd/system/chatwoot-web.1.servicecp /home/chatwoot/chatwoot/deployment/chatwoot-worker.1.service /etc/systemd/system/chatwoot-worker.1.servicecp /home/chatwoot/chatwoot/deployment/chatwoot.target /etc/systemd/system/chatwoot.target
# Restart the chatwoot serversystemctl restart chatwoot.target

If precompile fails#

If the asset precompilation step fails with ActionView::Template::Error (Webpacker can't find application.css in /home/chatwoot/chatwoot/public/packs/manifest.json) or if you face issues while restarting the server, try the following command and restart the server.

RAILS_ENV=production rake assets:clean assets:clobber assets:precompile

This command would clear the existing compiled assets and would recompile all the assets. Read more about it here

Running Rails Console#

# Login as Chatwoot usersudo -i -u chatwoot
# Navigate to the Chatwoot directorycd chatwoot
# start rails consoleRAILS_ENV=production bundle exec rails c

Viewing Logs#

Run the following commands in your ubuntu shell

# logs from the rails serverjournalctl -u chatwoot-web.1.service -f
# logs from sidekiqjournalctl -u chatwoot-worker.1.service -f