How to Install Foodsoft on Windows 10

Foodsoft is a web-based software designed for food co-ops to manage their orders and inventory. Here is a step-by-step guide on how to install Foodsoft on Windows 10:

Prerequisites

Before installing Foodsoft, make sure the following software is installed on your system:

  • Ruby 2.6
  • Node.js

Step 1: Download and Install Git

Git is a version control system that we'll need to download in order to install Foodsoft. Here's how to download and install Git:

  1. Go to the Git homepage at https://git-scm.com/download/win
  2. Click the "Download" button for the Windows version of Git.
  3. Once the download is complete, open the installer and follow the prompts to complete the installation.

Step 2: Clone Foodsoft Repository

Now that you have Git set up, it’s time to clone the Foodsoft repository:

  1. Open the Windows Command Prompt by pressing Win + X and selecting "Command Prompt (Admin)".
  2. Navigate to the directory where you want to store the Foodsoft files by running the command: cd [directory]
  3. Clone the Foodsoft repository by running the command: git clone https://github.com/foodcoops/foodsoft.git

Step 3: Install Required Libraries and Gems

Foodsoft requires a set of libraries and gems to run. Here’s how to install them:

  1. Open the Command Prompt and navigate to the Foodsoft directory using the command: cd [path-to-foodsoft-folder]
  2. Run the command: bundle install to install the required gems.
  3. Run the command: npm install to install the required node modules.

Step 4: Set Up the Database

Foodsoft uses MySQL as its database system. Here’s how to set up the database:

  1. Install MySQL on your system.
  2. Open the MySQL command line and create a new database using the command: CREATE DATABASE [database name];
  3. Copy the config/database.yml.template file to config/database.yml by running the command: cp config/database.yml.template config/database.yml
  4. In config/database.yml, set the database name, username, and password to your MySQL database information.

Step 5: Set Up Environment Variables

Foodsoft uses environment variables to store sensitive information such as passwords and API keys. Here’s how to set up the environment variables:

  1. Copy the .env.template file to .env by running the command: cp .env.template .env
  2. Open the .env file and set the necessary variables to the values you want to use.

Step 6: Start the Server

We’re now ready to start the Foodsoft server:

  1. In the Command Prompt, navigate to the Foodsoft directory by running the command: cd [path-to-foodsoft-folder]
  2. Run the command: rails server to start the server.
  3. Open your web browser and go to http://localhost:3000 to access the Foodsoft website.

Congratulations! You now have Foodsoft installed on your Windows 10 system.