[Community App] Foodsoft, software to manage a non-profit food coop

Foodsoft

Integration level

Install Foodsoft with YunoHost

Lire ce readme en français.

This package allow you to install Foodsoft quickly and simply on a YunoHost server.

If you don’t have YunoHost, please see here to know how to install and enjoy it.

Overview

Web-based software to manage a non-profit food coop (product catalog, ordering, accounting, job scheduling). A food cooperative is a group of people that buy food from suppliers of their own choosing. A collective do-it-yourself supermarket. Members order their products online and collect them on a specified day. And all put in a bit of work to make that possible. Foodsoft facilitates the process.

https://foodcoops.github.io/

Shipped version: v4.6.0

Credentials

LDAP is not supported yet. Setting an administrator password at install time is also not supported yet. However, we do support setting the administrator profile details like username, first name, last name and email. When you first log in as the administrator, you must use the default value of secret. You should reset this password immediately.

Pre-installation steps

Please consider the following before installing:

  • This installation requires Ruby 2.3.x which is an old version of Ruby. For this reason, we need to install the libssl1.0-dev package which removes the latest libssl-dev package. Please keep this in mind if you also self-host other applications on the same Yunohost. You can check this by running apt remove libssl-dev and seeing if the package manager complains.

  • There are many configuration options asked at installation time. Please review the default configuration file for some help in learning what these are all about.

Status

  • This is a new package and quite experimental. Please test with care.
  • Only the install and remove actions work. Please see this ticket for progress on enabling the rest.
  • Make sure to review issues and on-going work on the issue tracker

Screenshots

You can also watch the video walkthrough of using the application over at Vimeo:

Demo

Configuration

  • You can use the web interface to configure most things.

  • Find the main application configuration at /var/www/foodsoft/config. Please note, any modifications of these files can be wiped on upgrade. We don’t have a good solution for that right now. We aim to make most things configurable at installation time.

Administration

  • You have a number of Systemd services to manage. You can check them out with:
    • systemctl status foodsoft - the rails server managed by passenger
    • systemctl status resque - the redis task runner

Documentation

YunoHost specific features

Multi-users support

Supported architectures

  • x86-64b - Build Status
  • ARMv8-A - Build Status
  • Stretch x86-64b - Build Status

Limitations

  • Unknown so far.

Additional information

Links

Developers info

Only if you want to use a testing branch for coding, instead of merging directly into master.

Please do your pull request to the testing branch.

To try the testing branch, please proceed like that.

$ yunohost app install https://github.com/YunoHost-Apps/foodsoft_ynh/tree/testing --debug
$ yunohost app upgrade foodsoft -u https://github.com/YunoHost-Apps/foodsoft_ynh/tree/testing --debug

Notes

Mirroring

2 Likes

OK, this is experimentally ready for testing.

Please read the README for full details.

$ yunohost app install https://github.com/YunoHost-Apps/foodsoft_ynh

Feedback on testing is very welcome.