How to Install Chatwoot on Debian 12
Installing Chatwoot on Debian 12… okay, so here’s the thing: it’s not perfect the first time. I’ve had Node.js versions fight me, PostgreSQL throw random errors, and some packages just refused to cooperate. But don’t panic, you’ll get it. Follow along and you’ll have all your chats, emails, and social messages in one place before you know it.
Chatwoot really makes life easier when it comes to managing conversations. You’ll reply faster, keep everything organized, and avoid the usual mess. And yeah, if something breaks or acts weird on the first try, that’s totally normal. we’ll cover the common hiccups so you won’t be stuck.
Let’s get it up and running so you can stop juggling tabs and start actually talking to your visitors.
Prerequisites for installing Chatwoot on Debian 12
A minimum of 2 GB of RAM; however, 4 GB or more is preferred.
2 or more CPUs
A minimum of 10GB of available disk space to install and run Chatwoot and its dependencies.
Recommended Service: Linux VPS
Step 1: Update Your System
First, update your Debian 12 system using the following commands:
sudo apt update
sudo apt upgrade
Step 2: Install Dependencies
First, install the required dependencies. To install these dependencies, you need execute the following command:
sudo apt install git curl wget unzip build-essential libssl-dev libreadline-dev zlib1g-dev
Step 3: Install Node.js
Chatwoot requires Node.js to run. The NodeSource repository can be used to install Node.js. You may add the repository and install the Node.js package using the commands below:
curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -
sudo apt install -y nodejs
Step 4: Install Ruby and Rails
Ruby on Rails is the framework used to develop Chatwoot, which means you have to install Ruby and Rails on your machine. To install Ruby and Rails, please execute the following commands:
sudo apt install -y ruby-full ruby-dev build-essential
sudo gem install bundler
Step 5: Install PostgreSQL
Chatwoot uses PostgreSQL as its database. Run the command below to install postgresql:
sudo apt install postgresql postgresql-contrib
Step 6: Download and Configure Chatwoot
Now that the installation of all dependencies has been completed, you can download and configure Chatwoot.
Clone the chatwoot repository and create a configuration file for the repository using the following commands.
git clone https://github.com/chatwoot/chatwoot.git
cd chatwoot
cp config/application.yml.example config/application.yml
In this step, we will install the required packages for Chatwoot. Run the following commands:
bundle install
yarn install
Select the applicable database options for your system and set them as active schemes:
bundle exec rake db:create db:schema:load
Proceed with the following command to begin the Chatwoot server:
bundle exec rails s
To configure Chatwoot, simply enter into a web address “http://localhost:3000” on a web browser. Immediately an account setup wizard will be displayed prompting the user to create their account to then enable Chatwoot for customer communication.
Troubleshooting common installation issues
Database connection issues are fairly common during a Chatwoot installation. If you see an error saying the database cannot be reached, the first thing to check is whether the PostgreSQL service is running.
sudo systemctl status postgresql
If the PostgreSQL service is not running, start it with the following command:
sudo systemctl start postgresql
Also check the credentials in the .env file. They should match the PostgreSQL user you created earlier.
If you run into issues during installation, Node.js or npm dependencies are often the reason. In that case, remove any incorrect Node.js versions and run the installation commands again.
sudo apt install -y build-essential
Conclusion
Chatwoot is now installed on your Debian 12 server. You can open the dashboard in your browser and finish the initial setup. From here, you can start adding inboxes and handling your chats, emails, and other messages from a single place.
