Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Current »

This document provides an overview on how to install farmstack-steward on any linux instance.

Samuel Abate

Amanuel Negash

Mayank (Unlicensed)

Introduction

Farmstack steward is a web application which can be installed on any linux instance. As a part of steward setup, one would be receiving a python script which would install or setup the complete farmstack steward system.

For more information on farmstack-steward, kindly refer to the FS Steward document.

System Requirements

vCPUs

2

RAM(GiB)

4.0

Persistent Memory(GiB)

16

Operating System

Linux

Prerequisites

We use docker as a platform-as-a-service to run farmstack-steward. Hence, docker is a pre-requisite. In case, you have trouble installing docker on your instance, refer to install-docker script.

Once docker is installed, we have a couple of more pre-requisites to run farmstack-steward flawlessly which are as follows

  • SendGrid API Key and Verified Email with SendGrid - To configure e-mail service for steward.

  • Domain Name - For your domain to be public.

  • Google Client ID - For OAUTH Based Authentication(Google Sign in)

Installation overview

Once you have everything ready. You need to run the python script(setup.py). While the script is executing, it will ask information about the environment variables you would like to set.

Do provide all the details(including sendgrid, google clientId, and domain).

To verify if the entire setup, run the following command which should show 4 docker services running. In case of any issues, feel free to contact Team Farmstack.

docker ps

Frequent Error Messages or TroubleShooting

  • No labels

0 Comments

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account.