Updating Lightning

Lightning has a two-pronged update process. Although when it is initially installed, Lightning includes a useful, near-complete default configuration for your website, after it is installed all of that configuration is "owned" by your website. Because of this, Lightning cannot safely modify your website without potentially changing your its behavior, or, in a worst-case scenario, causing data loss.

As it evolves, Lightning's default configuration can change, and in certain limited cases, Lightning will attempt to safely update configuration that it depends on (which will usually be locked to prevent you from modifying it). Otherwise, Lightning will not modify your configuration, respecting the fact that your website owns it.

This set of behaviors, then, requires that you use the following process to update your Lightning installation.

To update the installed version of Lightning for your website, complete the following steps:

  1. Update your Lightning files based on your selected method:
    • Composer (These steps are useful if you installed Lightning using our Composer-based project template.)
      1. Open a command prompt window, and then navigate to your docroot.
      2. Run the following command:

        composer update
    • Updating using an installation file (also called a tarball)
      1. Download the latest version of Lightning, and then extract it to a folder on your computer.
      2. Replace the profiles/lightning directory with the directory included with the installation file that you just extracted to your computer.
      3. Replace your core directory with the directory included with the installation file that you just extracted to your computer.
  2. Update the database by using one of the following methods:
    • From a command prompt window, run the following command:

      drush updatedb
    • In your browser, go to http://mysite.com/update.php (where mysite.com is the URL for your website).
  3. Visit the Manual update steps section of the Lightning GitHub repository, and then follow the instructions for your version of Lightning.

Add new comment

Plain text

  • No HTML tags allowed.
  • Lines and paragraphs break automatically.
  • Web page addresses and email addresses turn into links automatically.

Contact supportStill need assistance? Contact Acquia Support