talk/INSTALL.md

Installation

Requirements

• Any flavour of Linux, OSX or Windows
• 1GB memory (minimum)
• 5GB storage (minimum)
• MongoDB v3.4 or later
• Redis v3.2 or later

Installation From Source

Requirements

There are some runtime requirements for running Talk from source:

• Node v7.9 or later
• Yarn v0.22.0 or later

Please be sure to check the versions of these requirements. Incorrect versions of these may lead to unexpected errors!

Installing

Download

It is highly recommended that you download a released version as the code available in master may not be stable. You can download the latest release from the releases page.

You can also clone the git repository via:

git clone https://github.com/coralproject/talk.git

Setup

We now have to install the dependancies and build the static assets.

# Install package dependancies
yarn

# Build static files
yarn build

Running

Refer to the README.md file for required configuration variables to add to the environment.

You can start the server after configuring the server using the command:

yarn start

This will setup the server to serve everything on a single node.js process.

You can see other scripts we've made available by consulting the package.json file under the scripts key including:

• yarn test run unit tests
• yarn e2e run end to end tests
• yarn build-watch watch for changes to client files and build static assets
• yarn dev-start watch for changes to server files and reload the server

Installation From Docker

We currently support packaging the Talk application via Docker, which automates the dependancy install and asset build process.

Requirements

There are some runtime requirements for running Talk for Docker:

• Docker v1.13.0 or later
• Docker Compose v1.10.0 or later

Please be sure to check the versions of these requirements. Incorrect versions of these may lead to unexpected errors!

Installing

An example docker-compose.yml:

version: '2'
services:
  talk:
    image: coralproject/talk:1.5
    restart: always
    ports:
      - "5000:5000"
    depends_on:
      - mongo
      - redis
    environment:
      - TALK_MONGO_URL=mongodb://mongo/talk
      - TALK_REDIS_URL=redis://redis
  mongo:
    image: mongo:3.2
    restart: always
    volumes:
      - mongo:/data/db
  redis:
    image: redis:3.2
    restart: always
    volumes:
      - redis:/data
volumes:
  mongo:
    external: false
  redis:
    external: false

At this stage, you should refer to the README.md for configuration variables that are specific to your installation. Some pre-defined fields have been filled in the above example which are consistent with Docker Compose naming conventions for Docker Links.

Running

# Start the services using compose
docker-compose up -d