Ubuntu installation guide


Open a terminal and run the following commands

sudo apt-get update

Install Git

sudo apt-get install git

Install RVM

You need software-properties-common installed in order to add PPA repositories.

sudo apt-get install software-properties-common
sudo apt-add-repository -y ppa:rael-gc/rvm
sudo apt-get update
sudo apt-get install rvm

Enable Run command as a login shell in terminal Preferences. Restart your computer

Install Ruby

Chatwoot APIs are built on Ruby on Rails, you need install ruby 2.6.3

rvm install ruby-2.6.3

Use ruby 2.6.3 as default

rvm use 2.6.3 --default

Install Node.js

Install Node.js from NodeSoure using the following commands

curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
sudo apt-get install -y nodejs

Install yarn

We use yarn as package manager

curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt-get update && sudo apt-get install yarn

Install postgres

The database used in Chatwoot is PostgreSQL. Use the following commands to install postgres.

sudo apt install postgresql postgresql-contrib

The installation procedure created a user account called postgres that is associated with the default Postgres role. In order to use Postgres, you can log into that account.

sudo -u postgres psql

Install libpg-dev dependencies for ubuntu

sudo apt-get install libpq-dev

Install redis-server

Chatwoot uses Redis server in agent assignments and reporting. To install redis-server

sudo apt-get install redis-server

Enable Redis to start on system boot.

sudo systemctl enable redis-server.service

Install imagemagick

sudo apt-get install imagemagick

Next: Read project setup to install project dependencies