From a54e03a3eb2608ae172cd8ab898173d9658549ae Mon Sep 17 00:00:00 2001 From: Francis Kayiwa Date: Tue, 22 Feb 2022 08:10:06 -0500 Subject: [PATCH] use AWS LightSail --- docs/cloud/aws.md | 24 ++++++++++++++++++++---- docs/local.md | 16 +++++++++++++--- docs/macOSREADME.md | 29 +++++++++++++++++++++++++++++ 3 files changed, 62 insertions(+), 7 deletions(-) create mode 100644 docs/macOSREADME.md diff --git a/docs/cloud/aws.md b/docs/cloud/aws.md index 314fe6c1..9f80545a 100644 --- a/docs/cloud/aws.md +++ b/docs/cloud/aws.md @@ -1,7 +1,23 @@ -# AWS +## AWS Lightsail Service Provider -I'm baby iPhone shoreditch af hella, hoodie put a bird on it DIY poutine live-edge synth ethical tacos. Umami adaptogen art party slow-carb. Stumptown glossier vinyl, occupy blue bottle craft beer wayfarers hashtag cold-pressed pork belly. Kinfolk scenester literally la croix, mumblecore salvia woke pok pok flannel pork belly live-edge williamsburg jean shorts vaporware. Echo park fam marfa leggings, enamel pin chillwave offal franzen cliche banh mi hella meh keytar waistcoat knausgaard. -Celiac vinyl prism copper mug PBR&B kickstarter kombucha. Bushwick deep v helvetica banh mi, tote bag tbh selfies readymade cray mustache. Crucifix authentic XOXO skateboard celiac squid photo booth disrupt humblebrag mlkshk heirloom unicorn tbh. Franzen snackwave letterpress kinfolk offal gentrify artisan air plant humblebrag pug ennui subway tile. +***The following instructions will cost you money. Please remember to turn off your VPS when you are done*** -Flexitarian pour-over fingerstache gastropub retro craft beer blue bottle. Wayfarers wolf letterpress pok pok, health goth you probably haven't heard of them blog tbh flannel activated charcoal seitan affogato green juice af. Asymmetrical drinking vinegar blue bottle ethical banh mi pabst. Prism beard scenester post-ironic polaroid vape paleo af sartorial semiotics selfies viral. Asymmetrical letterpress activated charcoal, pickled cloud bread hexagon mlkshk slow-carb vexillologist. Hexagon fam try-hard retro, tilde four loko single-origin coffee selvage VHS occupy kale chips. +* Mininally you will need to [install Ansible](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html) Ansible will be used to configure the Virtual Private Server you will be setting up on [AWS Lightsail](https://aws.amazon.com/lightsail/?p=gsrc&c=ho_lvm) that will be hosting the docnow app. +* You will need to [create ssh-keys](https://www.scaleway.com/en/docs/configure-new-ssh-key/) + +### Configure your account + +* Follow the instructions to [create an account here](https://portal.aws.amazon.com/billing/signup?client=lightsail&fid=1A3F6B376ECAC516-2C15C39C5ACECACB&redirect_url=https%3A%2F%2Flightsail.aws.amazon.com%2Fls%2Fsignup#/start) + + +### Create your Virtual Machine + +* Create your [Virtual Private Server](https://aws.amazon.com/getting-started/hands-on/launch-a-virtual-machine/) + * Select France or Amsterdam + * Select Linux/Unix platform option + * Select either Ubuntu (18.04) or Centos (7) + + + +### Launch your application diff --git a/docs/local.md b/docs/local.md index 74ad9156..fb839140 100644 --- a/docs/local.md +++ b/docs/local.md @@ -1,7 +1,17 @@ # Run Locally -I'm baby iPhone shoreditch af hella, hoodie put a bird on it DIY poutine live-edge synth ethical tacos. Umami adaptogen art party slow-carb. Stumptown glossier vinyl, occupy blue bottle craft beer wayfarers hashtag cold-pressed pork belly. Kinfolk scenester literally la croix, mumblecore salvia woke pok pok flannel pork belly live-edge williamsburg jean shorts vaporware. Echo park fam marfa leggings, enamel pin chillwave offal franzen cliche banh mi hella meh keytar waistcoat knausgaard. +## Install on Centos -Celiac vinyl prism copper mug PBR&B kickstarter kombucha. Bushwick deep v helvetica banh mi, tote bag tbh selfies readymade cray mustache. Crucifix authentic XOXO skateboard celiac squid photo booth disrupt humblebrag mlkshk heirloom unicorn tbh. Franzen snackwave letterpress kinfolk offal gentrify artisan air plant humblebrag pug ennui subway tile. +Steps to install on [CentOS](centOSREADME.md) -Flexitarian pour-over fingerstache gastropub retro craft beer blue bottle. Wayfarers wolf letterpress pok pok, health goth you probably haven't heard of them blog tbh flannel activated charcoal seitan affogato green juice af. Asymmetrical drinking vinegar blue bottle ethical banh mi pabst. Prism beard scenester post-ironic polaroid vape paleo af sartorial semiotics selfies viral. Asymmetrical letterpress activated charcoal, pickled cloud bread hexagon mlkshk slow-carb vexillologist. Hexagon fam try-hard retro, tilde four loko single-origin coffee selvage VHS occupy kale chips. +## Install on macOS + +Steps to install on [macOS](macOSREADME.md) + +## Install on Microsoft Windows + +Steps to install on [Microsoft Windows](mswinOSREADME.md) + +## Install on Ubuntu + +Steps to install on [Ubuntu](ubuntuREADME.md) \ No newline at end of file diff --git a/docs/macOSREADME.md b/docs/macOSREADME.md new file mode 100644 index 00000000..ea4b9a99 --- /dev/null +++ b/docs/macOSREADME.md @@ -0,0 +1,29 @@ +## On macOS + +If you intend to run Docnow on macOS (tested on Monterey) + +### Prerequisites + +* At least 8GB memory +* Install [Homebrew](https://brew.sh) +* Git +* Install [Docker](https://docs.docker.com/install/linux/docker-ce/centos/) and [Docker compose](https://docs.docker.com/compose/install/) +* (optional) reverse proxy web server ideally with TLS. Your reverse proxy server will listen on port 3000 for the docnow application + + +### Installing Docnow + + +```bash +brew install git +``` + +To install Docnow from the repository, clone the repository locally: + +```bash +git clone https://github.com/docnow/docnow.git +cd docnow +docker-compose up -d +``` + +Launch your preferred browser and open up: [http://localhost:3000](http://localhost:3000) \ No newline at end of file