This guide will help you to install Chatwoot on Ubuntu 20.04 LTS / 20.10. We have prepared a deployment script for you to run. Refer to the script and feel free to make changes accordingly to OS if you are on a non-Ubuntu system.
- Create a setup.sh file and copy the content from the above link or use the following commands.
Execute the script, and it will take care of the initial Chatwoot setup.
Chatwoot Installation will now be accessible at
Note: If you are running the script on Ubuntu VM on AWS EC2, make sure that you are logged in as
root user not as the
- Create an
chatwoot.mydomain.comon your domain management system and point it towards the installation IP address
- Continue with the installation script by entering
yeswhen prompted about domain setup.
- Enter your domain, and the script will take care of configuring Nginx and SSL
- Your Chatwoot installation should be accessible from the
For your Chatwoot installation to properly function, you would need to configure the essential environment variables like
FRONTEND_URL, Mailer and a cloud storage config. Refer Environment variables for the full list.
- Login as Chatwoot and edit the .env file.
Refer Environment variables and update the required variables. Save the
Restart the Chatwoot server and enjoy using your self hosted Chatwoot.
Whenever a new version of Chatwoot is released, use the following steps to upgrade your instance.
Run the following steps on your VM. Make changes based o your OS if you are on a non-Ubuntu system.
If the asset precompilation step fails with
ActionView::Template::Error (Webpacker can't find application.css in /home/chatwoot/chatwoot/public/packs/manifest.json) or if you face issues while restarting the server, try the following command and restart the server.
This command would clear the existing compiled assets and would recompile all the assets. Read more about it here
Run the following commands in your ubuntu shell