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/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 to install ruby 3.2.2:

rvm install ruby-3.2.2

Use ruby 3.2.2 as default:

rvm use 3.2.2 --default

Install Node.js

Chatwoot requires node version 20. Install Node.js from NodeSource using the following commands:

curl -sL https://deb.nodesource.com/setup_20.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