How to Install Chatwoot on Linux Mint

Chatwoot is an open-source customer communication platform that enables businesses to engage with their customers seamlessly across multiple channels. This tutorial will guide you through the steps required to install Chatwoot on your Linux Mint latest system.

Prerequisites

Before you get started with the installation process, ensure that you have the following prerequisites:

Step 1: Install Dependencies

Before installing the Chatwoot application, you need to install the dependencies required to run the application. To install the dependencies, open the terminal on your Linux Mint system and run the following commands:

$ sudo apt update
$ sudo apt install -y curl gnupg2 dirmngr software-properties-common

Step 2: Install Node.js

Next, you need to install Node.js on your system. Chatwoot requires Node.js to be installed to run the application.

To install Node.js, run the following command on your terminal:

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

Verify the Node.js installation by running the following command:

$ node -v

Output:
v14.x.x

Step 3: Install PostgreSQL

Chatwoot needs a database to store and manage its data. For this, we will use PostgreSQL, an open-source relational database management system.

To install PostgreSQL, run the following command on your terminal:

$ sudo apt install -y postgresql postgresql-contrib libpq-dev

After installing PostgreSQL, start the service and set it to start at boot time by running the following command:

$ sudo systemctl start postgresql

$ sudo systemctl enable postgresql

Step 4: Install Redis

Chatwoot uses Redis, an in-memory data structure store used as a database, cache, and message broker. Redis is used to store the chat history and session data.

To install Redis, run the following command on your terminal:

$ sudo apt install -y redis-server

After installing Redis, start the service and set it to start at boot time by running the following command:

$ sudo systemctl start redis

$ sudo systemctl enable redis

Step 5: Download and Install Chatwoot

To download and install Chatwoot, follow the below steps:

Download and Install the Chatwoot CLI tool

Chatwoot provides a CLI tool to help developers set up their Chatwoot instance quickly. To download and install the Chatwoot CLI tool, run the following command:

$ sudo npm install -g chatwoot-cli

Create a Chatwoot User

Next, create a new user for your Chatwoot instance using the following command:

$ sudo chatwoot user:create

Output: 
[INFO] New user created successfully.
[INFO] Email: [email]
[INFO] Password: [password]

Install Chatwoot

Lastly, install Chatwoot by running the following command:

$ sudo chatwoot install

The installation process will take some time to complete. Once the installation is complete, you will see the following output:

[INFO] Chatwoot successfully installed!
[INFO] Start the app by running: chatwoot start

Step 6: Start the Chatwoot Application

To start the Chatwoot application, use the following command on your terminal:

$ sudo chatwoot start

Once the server has started, visit http://localhost:3000 in your web browser. You will be redirected to the Chatwoot login page. Enter the email and password you created earlier to log in and start using Chatwoot.

Congratulations! You have successfully installed Chatwoot, the open-source customer communication platform, on your Linux Mint system. Enjoy engaging with your customers seamlessly.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!

Alternatively, for the best virtual desktop, try Shells!