mirror of
				https://github.com/lingble/chatwoot.git
				synced 2025-10-31 02:57:57 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			113 lines
		
	
	
		
			2.2 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			113 lines
		
	
	
		
			2.2 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
| ---
 | |
| path: "/docs/installation-guide-mac-os"
 | |
| title: "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
 | |
| 
 | |
| ```bash
 | |
| xcode-select --install
 | |
| ```
 | |
| 
 | |
| ### Install Homebrew
 | |
| 
 | |
| ```bash
 | |
| ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
 | |
| ```
 | |
| 
 | |
| ### Install Git
 | |
| 
 | |
| ```bash
 | |
| brew update
 | |
| brew install git
 | |
| ```
 | |
| 
 | |
| ### Install RVM
 | |
| 
 | |
| You need software-properties-common installed in order to add PPA repositories.
 | |
| 
 | |
| ```bash
 | |
| curl -L https://get.rvm.io | bash -s stable
 | |
| source ~/.rvm/scripts/rvm
 | |
| ```
 | |
| 
 | |
| ### Install Ruby
 | |
| 
 | |
| Chatwoot APIs are built on Ruby on Rails, you need install ruby 2.7.2
 | |
| 
 | |
| If you are using `rvm` :
 | |
| 
 | |
| ```bash
 | |
| rvm install ruby-2.7.2
 | |
| rvm use 2.7.2
 | |
| ```
 | |
| 
 | |
| If you are using `rbenv` to manage ruby versions do :
 | |
| 
 | |
| ```bash
 | |
| rbenv install 2.7.2
 | |
| ```
 | |
| 
 | |
| `rbenv` identifies the ruby version from `.ruby-version` file on the root of the project and loads it automatically.
 | |
| 
 | |
| ### Install Node.js
 | |
| 
 | |
| Install Node.js from NodeSoure using the following commands
 | |
| 
 | |
| ```bash
 | |
| brew install node
 | |
| ```
 | |
| 
 | |
| ### Install yarn
 | |
| 
 | |
| We use `yarn` as package manager
 | |
| 
 | |
| ```bash
 | |
| brew install yarn
 | |
| ```
 | |
| 
 | |
| ### Install postgres
 | |
| 
 | |
| The database used in Chatwoot is PostgreSQL. Use the following commands to install postgres.
 | |
| 
 | |
| ```bash
 | |
| brew install postgresql
 | |
| ```
 | |
| 
 | |
| 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.
 | |
| 
 | |
| ```bash
 | |
| sudo -u postgres psql
 | |
| ```
 | |
| 
 | |
| ### Install redis-server
 | |
| 
 | |
| Chatwoot uses Redis server in agent assignments and reporting. To install `redis-server`
 | |
| 
 | |
| ```bash
 | |
| brew install redis
 | |
| ```
 | |
| 
 | |
| Enable Redis to start on system boot.
 | |
| 
 | |
| ```bash
 | |
| launchctl unload ~/Library/LaunchAgents/homebrew.mxcl.redis.plist
 | |
| ```
 | |
| 
 | |
| ### Install imagemagick
 | |
| Chatwoot uses `imagemagick` library to resize images for showing previews and smaller size based on context.
 | |
| 
 | |
| ```bash
 | |
| brew install imagemagick
 | |
| ```
 | |
| 
 | |
| You can read more on installing imagemagick from source from [here](https://imagemagick.org/script/download.php).
 | |
| 
 | |
| ### Install Docker
 | |
| 
 | |
| This is an optional step. Those who are doing development can install docker from [Docker Desktop](https://www.docker.com/products/docker-desktop).
 | 
