Skip to content
Help Center

How to install Chatwoot on your VPS step by step

Centralize your WhatsApp, Instagram, and website chats on your own server with a practical Chatwoot installation guide.

If you want the fastest path without unnecessary complexity, this is it. Chatwoot has polished its installer so the server can do most of the heavy lifting for you with just a few commands.

3-step installation guide

Before you begin, connect to your server over SSH as the root user.

1. Download the official script

This command downloads the latest installation assistant directly from the Chatwoot repositories:

wget https://get.chatwoot.app/linux/install.sh

2. Grant execution permissions

To allow the file to run on the server:

chmod +x install.sh

3. Start the installation

Now execute it. The --install parameter tells the script to configure everything from scratch, including the database, Redis, Nginx, and the required runtime components:

./install.sh --install

Expert note: you will see a lot of output on screen. That is normal. The server is installing dependencies such as Ruby and Node.js and applying the basic configuration.


Bacan pro tip

Watch your VPS resources. Chatwoot is not a lightweight application. If the installer stalls near the end or the panel feels slow afterward, check whether your VPS has SWAP memory enabled. On a Bacan VPS, adding 2 GB of SWAP can help prevent instability during installation or under simultaneous chat load.


Important details

  • Have the domain ready: point the chosen subdomain to your VPS IP before running the script if you want SSL to configure properly on the first attempt.

  • Prepare SMTP settings: Chatwoot needs to send email so you can validate and use accounts correctly.

  • Secure the firewall: after installation, confirm that only the necessary ports remain open, typically 80, 443, and 22 for SSH.