ensl.org/INSTALL.md

# Install (Ubuntu LTS)

ENSL Website is fairly easy to run.

## 1. Install requirements: docker, docker-compose and git

https://docs.docker.com/install/
https://docs.docker.com/compose/install/

Install docker + docker-compose:

    wget -O - 'https://get.docker.com/'|bash
    sudo curl -L https://github.com/docker/compose/releases/download/1.18.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose

Install git: https://git-scm.com/book/en/v2/Getting-Started-Installing-Git

    sudo apt-get install git

## 2. Download ENSL website and install it

Now create the required directories, e.g. `/srv/ensl.org`

    git clone git@github.com:ENSL/ensl.org.git

Create the `.env` file by copying `.env.example` with the appropriate credentials.

    cd ensl.org && cp .env.example .env
    gedit .env

If the database does not exist, it will be created with settings from .env file so make sure you configure it.

First build the ENSL docker containers.

    docker-compose build

Put any database dumps to `db/initdb.d`.

a) Then start for **production**:
    
    docker-compose up

b) ... or start for **development**:

    docker-compose -f docker-compose.dev.yml up

## 3. Install reverse proxy (production only)

Install apache, nginx etc. reverse proxy. It will take requests from the users and pass them to ENSL website. Sample configuration availble @ ext/nginx.

https://www.nginx.com/resources/wiki/start/

    sudo apt-get install nginx

*Skip this step if you are only doing development.*
Fix tinymce Update docs Update dockerfile, fix js issue, cleanup env files 2020-03-18 19:11:10 +00:00			`# Install (Ubuntu LTS)`
Purged git history and removed sensitive information. 2014-03-23 00:22:25 +00:00
Update production docs 2020-03-16 21:58:44 +00:00			`ENSL Website is fairly easy to run.`
Purged git history and removed sensitive information. 2014-03-23 00:22:25 +00:00
Update Dockerfile + docs 2020-03-21 20:32:48 +00:00			`## 1. Install requirements: docker, docker-compose and git`
Silence deprecation warning in production Fix rbenv not being able to export to upstart via foreman 2014-03-23 04:13:19 +00:00
Update production docs 2020-03-16 21:58:44 +00:00			`https://docs.docker.com/install/`
			`https://docs.docker.com/compose/install/`
Silence deprecation warning in production Fix rbenv not being able to export to upstart via foreman 2014-03-23 04:13:19 +00:00
Update production docs 2020-03-16 21:58:44 +00:00			`Install docker + docker-compose:`
Purged git history and removed sensitive information. 2014-03-23 00:22:25 +00:00
Update production docs 2020-03-16 21:58:44 +00:00			`wget -O - 'https://get.docker.com/'\|bash`
			sudo curl -L https://github.com/docker/compose/releases/download/1.18.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
Improve install log Remove unused files Update .env.example 2014-03-23 00:56:13 +00:00
Update Dockerfile + docs 2020-03-21 20:32:48 +00:00			`Install git: https://git-scm.com/book/en/v2/Getting-Started-Installing-Git`
Fix tinymce Update docs Update dockerfile, fix js issue, cleanup env files 2020-03-18 19:11:10 +00:00
Docs update 2020-03-22 12:49:27 +00:00			`sudo apt-get install git`
Updated unicorn config Updated gem versions Removed foreman 2014-03-25 11:15:49 +00:00
Docs update 2020-03-22 12:49:27 +00:00			`## 2. Download ENSL website and install it`
Improve install log Remove unused files Update .env.example 2014-03-23 00:56:13 +00:00
Update production docs 2020-03-16 21:58:44 +00:00			Now create the required directories, e.g. `/srv/ensl.org`
Improve install log Remove unused files Update .env.example 2014-03-23 00:56:13 +00:00
Update production docs 2020-03-16 21:58:44 +00:00			`git clone git@github.com:ENSL/ensl.org.git`
Purged git history and removed sensitive information. 2014-03-23 00:22:25 +00:00
Bump docs & build config ruby versions 2014-10-09 22:52:32 +00:00			Create the `.env` file by copying `.env.example` with the appropriate credentials.
Updated install instructions Added missing dalli gem to the Gemfile 2014-03-23 01:22:47 +00:00
Docs update 2020-03-22 12:49:27 +00:00			`cd ensl.org && cp .env.example .env`
			`gedit .env`
Updated unicorn config Updated gem versions Removed foreman 2014-03-25 11:15:49 +00:00
Update production docs 2020-03-16 21:58:44 +00:00			`If the database does not exist, it will be created with settings from .env file so make sure you configure it.`
Updated unicorn config Updated gem versions Removed foreman 2014-03-25 11:15:49 +00:00
Docs update 2020-03-22 12:49:27 +00:00			`First build the ENSL docker containers.`
Fixed formatting and ruby hash syntax 2014-03-31 21:33:16 +00:00
Update production docs 2020-03-16 21:58:44 +00:00			`docker-compose build`
Fix tinymce Update docs Update dockerfile, fix js issue, cleanup env files 2020-03-18 19:11:10 +00:00
Update docker-compose to work with DB out of box 2020-03-31 02:31:42 +00:00			Put any database dumps to `db/initdb.d`.

Docs update 2020-03-22 12:49:27 +00:00			`a) Then start for production:`

			`docker-compose up`

			`b) ... or start for development:`

			`docker-compose -f docker-compose.dev.yml up`

			`## 3. Install reverse proxy (production only)`
Fix tinymce Update docs Update dockerfile, fix js issue, cleanup env files 2020-03-18 19:11:10 +00:00
			`Install apache, nginx etc. reverse proxy. It will take requests from the users and pass them to ENSL website. Sample configuration availble @ ext/nginx.`

			`https://www.nginx.com/resources/wiki/start/`

			`sudo apt-get install nginx`

			`Skip this step if you are only doing development.`