1) Install Docker on your VM
2) Download the required files
3) Tweak the
docker-compose.yml according to your preferences. Refer to the available environment variables. You could also remove the dependant services like
Redis etc., in favor of managed services configured via environment variables.
4) Prepare the database by running the migrations.
5) Get the service up and running.
6) Your Chatwoot installation should be accessible with
1) Have an
Nginx web server acting as a reverse proxy for Chatwoot installation. So that you can access Chatwoot from
docker-compose run --rm rails bundle exec rails db:chatwoot_prepare whenever you decide to update the Chatwoot images to handle the migrations.
- Configure Nginx to serve as a frontend proxy.
- Use the following Nginx config after replacing the
- Verify and reload your Nginx config by running the following command.
- Run Let's Encrypt to configure SSL certificate.
- Your Chatwoot installation should be accessible from the
We publish our base images to the Docker hub. You should be able to build your Chatwoot web/worker images from these base images.
The app servers will run available on port
3000. Ensure the images connect to the same database and Redis servers. Provide the configuration for these services via environment variables.
To set up the database for the first time, you must run
rails db:chatwoot_prepare. You may get errors if you try to run
rails db:migrate at this point.
Update the images using the latest image from chatwoot. Run the
rails db:chatwoot_prepare option after accessing the console from one of the containers running the latest image.