Setup

Installation

See the readme to ensure you have all project dependencies set up.

Setup a server instance

The current recommended OS is Ubuntu 20. Other versions, or other Debian based systems may work too. See current servers to get an idea of what other teams have used.

You will need to ensure Python2.7 is installed on your server, and that /usr/bin/python points to Python2.7. (playbook site.yml should do this for you when provisioning)

If you are going through this process the first time, you probably want to test it on your local machine first. Jump to Using Vagrant to create a local virtual machine and run the provisioning on that. You will have a real installation of the Open Food Network app on that virtual machine and will be able to test everything first.

Seed data

OFN is installed with Australia's states by default. The Open Food Foundation collects more localisation data repositories of other countries. They follow the name scheme l10n_<country-code> like l10n_gb or l10n_fr.

If you are the first to run an OFN app for a country, you have to create a repository with that data first. It should contain a file called states.yml.

Publish that repository somewhere accessible for your server. The Open Food Foundation will be happy to put your repository amongst the others. Then change the l10n_repo variable in your inventory to match your repository.

SSL certificate files

For production and staging environments, you will need SSL certificates for the domain name. ofn-install uses Let's Encrypt to automatically request a free certificate.

Next: Configuration of ofn-install