This is the installation guide for using the software “as is”. If you want to contribute to this project, please follow the developers installation in the project’s

If you have questions please drop Mario an email:

If you want to update your installation to another version, please read the migration guide.


That’s too much in depths for you? Look at this offer (German only) or drop Mario an email:

There are demo installations in German and English. Feel free to test before installing. New translations are welcome!

Download latest version to your server

The latest stable version is available at Do not clone from Git, you will get an unstable develop version! If you are a developer, please do clone the repository and don’t forget to change app.debug to true in your custom_config.php.

Download and unpack the ZIP file. Upload the content of the versioned folder to your server (e.g. using FTP). The destination folder must be accessible to your Apache Server, but not the Document Root (e.g. /var/www/foodcoopshop). Set the file access rights so that the Apache user (e.g. www-data) owns all files and folders:

me@home:/var/www$ sudo chown -R www-data:www-data foodcoopshop

Document Root / Virtual Host

If you develop on your local machine, your virtual host should end with “.test” (e.g. foodcoopshop.test). Then development environment and correct debug mode are set automatically. Simply add the prefered hostname to your local hosts file (e.g. /etc/hosts). Check in your browser by loading http://foodcoopshop.test/.

Create a new virtual host in your Apache configuration. Most common is copying /etc/apache2/sites-available/000-default.conf to 020-foodcoopshop.conf and symlinking it to /etc/apache2/sites-enabled:

me@home:/etc/apache2/sites-available$ sudo cp 000-default.conf 020-foodcoopshop.conf
me@home:/etc/apache2/sites-available$ sudo ln -sr 020-foodcoopshop.conf ../sites-enabled

Now use your favourite editor to edit the new config file 020-foodcoopshop.conf (you must have root rights to edit):

Then restart the webserver:

me@home:/etc/apache2/sites-available$ sudo service apache2 restart

Setting permissions

$ cd /var/www/foodcoopshop/
$ chmod a+w -R ./files_private
$ chmod a+w -R ./tmp
$ chmod a+w -R ./webroot/cache
$ chmod a+w -R ./webroot/files
$ chmod a+w -R ./webroot/tmp

Configuring FoodCoopShop

Database Setup


Testing your email configuration

Setup security keys

Open your domain https://yourdomain.tld in a browser and follow the steps shown to create secure values for the security keys app.cookieKey and Security.salt. Set them in custom_config.php

Create the valid Super Admin account


To enable all cronjobs, please read the cronjobs documentation.