Installing Chatwoot on Debian 11 is a relatively simple process, but it does require some technical knowledge and experience with the Linux command line. In this article, we will walk you through the steps necessary to install and configure Chatwoot on a server running Debian 11.
- Before you begin, make sure that your server meets the minimum system requirements for running Chatwoot. This includes having at least 1GB of RAM and 2GB of free disk space.
- Start by logging in to your server via SSH and updating the package manager index by running the following command:
sudo apt update
- Once the package manager index has been updated, you can install the necessary dependencies for Chatwoot by running the following command:
sudo apt install -y build-essential libpq-dev nodejs yarn
- Next, you will need to create a new user account for Chatwoot. This is recommended to ensure that the application has its own isolated environment to run in. To create a new user, run the following command:
sudo adduser --disabled-password chatwoot
- Once the user has been created, switch to the new user account by running the following command:
sudo su - chatwoot
- You are now ready to download and install Chatwoot. First, clone the Chatwoot repository from GitHub by running the following command:
git clone <https://github.com/chatwoot/chatwoot.git>
- This will create a new directory called
chatwoot
in your current working directory. Change into this directory by running the following command:
cd chatwoot
- Once you are in the
chatwoot
directory, you can install the necessary dependencies for the application by running the following command:
yarn install
- After the dependencies have been installed, you can generate a new configuration file for the application by running the following command:
bin/rails credentials:edit
- This will open the configuration file in your default text editor. Fill in the necessary values for the various settings, such as the database connection details and the SMTP settings for sending emails.
- Once you have finished configuring the application, you can create the necessary databases by running the following command:
bin/rails db:create
- Next, you will need to run the migrations to set up the database schema. This can be done by running the following command:
bin/rails db:migrate
- Finally, you can start the Chatwoot application by running the following command:
bin/rails server
- Chatwoot should now be running on your server. You can access the application by navigating to http://your-server-ip:3000 in your web browser.
- If you want to make the application accessible on a domain name rather than an IP address, you will need to set up a reverse proxy using a web server such as Apache or Nginx. Consult the Chatwoot documentation for more information on how to do this.
In conclusion, installing Chatwoot on Debian 11 is a straightforward process, but it does require some technical knowledge and experience with the Linux command line. By following the steps outlined in this article, you should be able to successfully install and configure Chatwoot on a server running Debian 11. As always, be sure to consult the official Chatwoot documentation for any additional information or troubleshooting assistance.