title |
---|
From version 2.2 to current |
This page provides an indepth guide of how to move an existing 2.2.x site up to the latest %%VERSION%% release. Since this is a major release you cannot assume that there will be no breaking changes and the complexity of the upgrade will vary a lot depending on how much custom code you have in your current site.
You will definitely make the process smoother by taking the following precautions.
- Make sure you are on the latest stable release of the 2.2.x series
- Make sure that you do a full backup of the site database, uploaded files, config files and the extensions directory.
- If possible have your current install under git source control and test any changes on a new branch which can then easily be reverted.
- If you come across any undocumented issues, let us know by raising an issue on GitHub
- Check that the extensions you need have versions available for Bolt %%VERSION%% on the Market Place
There are basically two methods to update an existing installation. Pick the one that most closely resembles your current installation:
- Basic: This describes the process of setting up a fresh Bolt %%VERSION%% install, and moving over all of your existing configuration, data, themes and uploaded media. Use it if you're using a common Bolt installation.
- Advanced: This describes the process of converting an existing Bolt 2.2 install to Bolt %%VERSION%%. Use this method if you're running a non-default Bolt installation, like a customized Composer install.
We recommend the first option, because it allows you to get a fresh install up and running, without hassle or leaving behind too many old files.