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

First select your environment (eg. development). Then use a script to load the env vars to your shell env:

    source script/env.sh .env .env.development

Second 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.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
Fix dotenv load 2020-04-05 03:30:14 +00:00			`First select your environment (eg. development). Then use a script to load the env vars to your shell env:`
Updated install instructions Added missing dalli gem to the Gemfile 2014-03-23 01:22:47 +00:00
Fix dotenv load 2020-04-05 03:30:14 +00:00			`source script/env.sh .env .env.development`
Updated unicorn config Updated gem versions Removed foreman 2014-03-25 11:15:49 +00:00
Fix dotenv load 2020-04-05 03:30:14 +00:00			`Second 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:`

Move back to docker-compose + fix env vars Fix env vars. Rely on inheritance. Add a script to load env vars as above. Fix staging env Add nginx conf and SSL directory Reorganize .gitignore Use multi-staged docker-compose + dockerfile Substitute env vars for static values 2020-04-05 02:58:41 +00:00			`docker-compose -f docker-compose.yml up`
Docs update 2020-03-22 12:49:27 +00:00
			`## 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.`