Skip to main content

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/rvmsudo apt-get updatesudo 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 to install ruby 2.7.2:

rvm install ruby-2.7.2

Use ruby 2.7.2 as default:

rvm use 2.7.2 --default

Install Node.js#

Install Node.js from NodeSource 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 the 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 creates 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. You need to install redis-server:

sudo apt-get install redis-server

Next, enable Redis to start on system boot:

sudo systemctl enable redis-server.service

Install imagemagick#

sudo apt-get install imagemagick