Outlines process for installing octofarm on macOS.

octofarm_macos.md

Installing OctoFarm on macOS

Notes:

• Below are the steps used to install OctoFarm in macOS using Homebrew.

• This was tested on macOS Mojave, 10.14.6. It should work on newer versions; however, I haven't confirmed whether this works.

Steps to Install

Setting Up Environment

First, install Homebrew; if Homebrew is already installed you can skip to installing packages below.

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Next, add Homebrew’s location to your $PATH in your .bash_profile or .zshrc file.

export PATH="/usr/local/bin:$PATH"

Install Packages

Before installing packages, it is recommended that you make sure Homebrew is up-to-date and running properly.

To do this:

• Run brew update

brew update

• Run brew doctor to make sure your system is ready to brew; follow any recommendations from brew doctor.

brew doctor

Install packages needed for OctoFarm to run.

• nodejs
• mongodb
• git

Commands below will install packages via Homebrew.

brew install node
brew install mongodb-community
brew install git

Start mongodb

brew services start mongodb/brew/mongodb-community

Clone OctoFarm and Install

Clone OctoFarm and cd into its directory.

git clone https://github.com/NotExpectedYet/OctoFarm.git

cd OctoFarm

Install NPM packages

npm install

Edit the /config/db.js file with your database and grab your hosts IP.

nano config/db.js

Change 192.168.1.5 to the mongodb server's IP Address (127.0.0.1 if you installed on the same machine, the actual IP Address otherwise), Save the File

Output Hostname IP.

ifconfig | grep "inet " | grep -Fv 127.0.0.1 | awk '{print $2}'

Start the system

npm start