Skip to main content

Mac OS installation guide

Open terminal app and run the following commands

Installing the standalone Command Line Tools

Open terminal app and write the code below

xcode-select --install

Install Homebrew

/bin/bash -c "$(curl -fsSL"

Install Git

brew update
brew install git

Install RVM or rbenv

curl -L | bash -s stable

Alternatively you can use rbenv

brew install rbenv

Install Ruby

Chatwoot APIs are built on Ruby on Rails, you need install ruby 3.2.2

If you are using rvm :

rvm install ruby-3.2.2
rvm use 3.2.2
source ~/.rvm/scripts/rvm

If you are using rbenv to manage ruby versions do :

rbenv install 3.2.2

rbenv identifies the ruby version from .ruby-version file on the root of the project and loads it automatically.

Install Node.js

Chatwoot requires node version 20. Install Node.js from NodeSource using the following commands

brew install node@20

Install yarn

We use yarn as package manager

brew install yarn

Install postgres

The database used in Chatwoot is PostgreSQL.

  1. Install PostgresApp ( This is easiest way to get started with PostgreSQL on mac.


  1. Use the following commands to install postgres.
brew install postgresql
# Ensure Postgres is started
brew services start postgresql
# create user postgres
createuser postgres

The installation procedure created a user account called postgres that is associated with the default Postgres role. In order to use Postgres, you can log into that account.

sudo psql -U postgres

Install redis-server

Chatwoot uses Redis server in agent assignments and reporting. To install redis-server

brew install redis

Start the redis service.

brew services start redis

Install imagemagick

Chatwoot uses imagemagick library to resize images for showing previews and smaller size based on context.

brew install imagemagick

You can read more on installing imagemagick from source from here.

Install Docker

This is an optional step. Those who are doing development can install docker from Docker Desktop.