Prerequisites Install Guide for Ubuntu

Tested on Ubuntu 18.04

This article will guide you through setting up OpenMappr for development on Ubuntu.

Inside a terminal window, perform the following steps:

1. Update your apt sources

sudo apt update

2. Remove any potential old versions of docker

sudo apt remove docker docker-engine docker.io containerd runc -y

3. Install OpenMappr dependencies via apt

sudo apt install curl build-essential ruby-full git python -y

4. Install the sass and compass gems

sudo gem install sass compass

5. Install docker

curl -sSL https://get.docker.com | sudo bash

6. Start and enable the docker service through systemd

sudo systemctl start docker
sudo systemctl enable docker

7. Install docker-compose

sudo curl -L "https://github.com/docker/compose/releases/download/1.25.4/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

8. Download and install nvm, Node Version Manager

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
export NVM_DIR="$HOME/.nvm" && [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

9. Install and use Node version 8.12.0

nvm install 8.12.0
nvm use 8.12.0

10. Install global NPM packages needed for development

npm install -g yo bower grunt-cli

That's it! Continue to the main readme for instructions on running the app.