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