For the new major version v3 a lot of legacy code was removed. Please ensure that your last v2.x installation at least runs two full months in production before updating to v3! The reason is, that in v2.2 / v2.3 the invoice generation was changed. If you don’t use the invoice cronjob, you can update to v3 immediately.
app.dateOfFirstSendInvoiceCronjobWithPickupDayUpdate can be removed
replace source code => see bottom of page
execute migrations => see bottom of page
PHP >= 7.3
MySQL >= 5.7.7 (to support utf8mb4)
execute migrations
execute $ bin/cake migrations migrate to execute database migrations. If you do not have shell access, you need to update the migrations manually. The files with the sql statements are located in the folder /config/Migrations).
replacing source code
rename old installation folder (e.g. foodcoopshop-old)
upload source code of new version into new folder with the name of the old version before renaming
copy the following files and folders from your old installation directory into the new directory
config/custom_config.php
config/credentials.php
webroot/files
files_private
and any other adapted files (favicons, /css/custom.css, /css/mobile-frontend-custom.css…)