How to Install Foodsoft on macOS

Introduction

Foodsoft is an open-source tool for managing food cooperatives, it is available from the following link: https://foodcoops.net/. This tutorial will guide you through the installation process of Foodsoft on macOS using Homebrew.

Prerequisites

Before installing Foodsoft, you must have Brew installed on your macOS. Brew is a package manager that simplifies the installation of software, it can be installed by running the following command in Terminal:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Installation

Open Terminal on your macOS, and enter the following commands to install the prerequisites:

brew install ruby

brew install imagemagick

brew install postgresql

Once the above prerequisites are installed, create a new PostgreSQL database by running this command:

createdb -O foodsoft foodsoft_development

Next, you need to install the foodsoft package. Run the following commands in Terminal to clone the Foodsoft repository and install its dependencies:

cd /usr/local/lib

sudo mkdir foodsoft

sudo chown -R $(whoami) $(brew --prefix)/*

git clone https://github.com/foodcoops/foodsoft.git /usr/local/lib/foodsoft

cd /usr/local/lib/foodsoft

gem install bundler

bundle install

Configuration

To configure Foodsoft, you need to create a .env file in the root directory of the project /usr/local/lib/foodsoft. Run the following command to create this file:

cp .env.example .env

Edit the .env file and set the following variables:

DB_NAME=foodsoft_development
DB_USER=foodsoft
DB_PASSWORD=yourpassword

Running Foodsoft

Run the following commands in Terminal to start the server:

cd /usr/local/lib/foodsoft

rails server

You should see the following message in Terminal:

=> Booting Puma

=> Rails 6.0.3.6 application starting in development

=> Run `rails server --help` for more startup options

Puma starting in single mode...

* Version 4.3.8 (ruby 2.7.2-p137), codename: Mysterious Traveller

* Min threads: 5, max threads: 5

* Environment: development

* Listening on tcp://127.0.0.1:3000

Use Ctrl-C to stop

Open your browser and navigate to http://localhost:3000/. Congratulations! You have successfully installed and configured Foodsoft on your macOS.

Conclusion

This tutorial provided you with step-by-step instructions on how to install and configure Foodsoft on macOS. Please note that you can customize the configuration of Foodsoft based on your specific requirements.