110 lines
2.1 KiB
Markdown
110 lines
2.1 KiB
Markdown
---
|
|
path: "/docs/installation-guide-ubuntu"
|
|
title: "Ubuntu installation guide"
|
|
---
|
|
|
|
Open a terminal and run the following commands
|
|
|
|
```bash
|
|
sudo apt-get update
|
|
```
|
|
|
|
### Install Git
|
|
|
|
```bash
|
|
sudo apt-get install git
|
|
```
|
|
|
|
### Install RVM
|
|
|
|
You need software-properties-common installed in order to add PPA repositories.
|
|
|
|
```bash
|
|
sudo apt-get install software-properties-common
|
|
```
|
|
|
|
```bash
|
|
sudo apt-add-repository -y ppa:rael-gc/rvm
|
|
sudo apt-get update
|
|
sudo apt-get install rvm
|
|
```
|
|
|
|
Enable `Run command as a login shell` in terminal `Preferences`. Restart your computer
|
|
|
|
### Install Ruby
|
|
|
|
Chatwoot APIs are built on Ruby on Rails, you need install ruby 2.6.5
|
|
|
|
```bash
|
|
rvm install ruby-2.6.5
|
|
```
|
|
|
|
Use ruby 2.6.5 as default
|
|
|
|
```bash
|
|
rvm use 2.6.5 --default
|
|
```
|
|
|
|
### Install Node.js
|
|
|
|
Install Node.js from NodeSoure using the following commands
|
|
|
|
```bash
|
|
curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
|
|
sudo apt-get install -y nodejs
|
|
```
|
|
|
|
### Install yarn
|
|
|
|
We use `yarn` as package manager
|
|
|
|
```bash
|
|
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
|
|
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
|
|
```
|
|
|
|
```bash
|
|
sudo apt-get update && sudo apt-get install yarn
|
|
```
|
|
|
|
### Install postgres
|
|
|
|
The database used in Chatwoot is PostgreSQL. Use the following commands to install postgres.
|
|
|
|
```bash
|
|
sudo apt install postgresql postgresql-contrib
|
|
```
|
|
|
|
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 `libpg-dev` dependencies for ubuntu
|
|
|
|
```bash
|
|
sudo apt-get install libpq-dev
|
|
```
|
|
|
|
### Install redis-server
|
|
|
|
Chatwoot uses Redis server in agent assignments and reporting. To install `redis-server`
|
|
|
|
```bash
|
|
sudo apt-get install redis-server
|
|
```
|
|
|
|
Enable Redis to start on system boot.
|
|
|
|
```bash
|
|
sudo systemctl enable redis-server.service
|
|
```
|
|
|
|
### Install imagemagick
|
|
|
|
```bash
|
|
sudo apt-get install imagemagick
|
|
```
|
|
|
|
Next: [Read project setup to install project dependencies](https://www.chatwoot.com/docs/dependencies)
|