Updating farmOS

ALWAYS BACKUP YOUR DATABASE, CODE, AND FILES BEFORE ATTEMPTING AN UPDATE!

New versions of farmOS will be released on a regular basis, and it's important to stay up-to-date so that you can receive new features, bug fixes, and security patches when they become available.

It is recommended that you either download the officially packaged releases of farmOS from https://drupal.org/project/farm or run farmOS on Docker. This will ensure that the necessary patches are applied, and that the farmOS distribution updates are included.

Note that automatic updates through Drupal's UI are disabled by farmOS See https://drupal.org/node/3136140 for more information.

Security updates

Occassionally there will be security updates to Drupal core and contributed modules, which will cause the following message to show in farmOS:

There is a security update available for your version of Drupal. To ensure the security of your server, you should update immediately! See the available updates page for more information.

When these upstream security updates are released, we update them in the development branches of farmOS as soon as possible. If the vulnerabilities are serious, we will also tag a new version release of farmOS. In many cases, a new release is not urgent because the vulnerability does not directly affect farmOS. If you would like to update before a new release is available, you can download a "development snapshot" from Drupal.org.

Update procedure

Updating farmOS is basically the same process as updating Drupal core. The following procedure will ensure that your update goes smoothly.

Docker note: if you are hosting farmOS in Docker, see Hosting farmOS with Docker for Docker-specific update instructions.

  1. Backup your database, code, and files! Always do this before updating. Be ready and able to roll-back in the event that something goes wrong.
  2. Download the new recommended release of farmOS from https://drupal.org/project/farm
  3. Unzip the compressed folder, and replace everything in your Drupal codebase EXCEPT the /sites/ folder. Do not overwrite the /sites/ folder, because it contains content and configuration for your site.
  4. Run database updates.

Optionally:

  • Revert all Features via Drush. If you have intentionally overridden any specific farmOS configurations, then you should NOT do this. You will need to resolve any merge conflicts with farmOS core Features changes in order to complete the upgrade. See developing with updates in mind.

    drush fra