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.
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)"
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
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
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.
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.
If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!
