Updating a Varbase Site
Last updated
Last updated
Updating Varbase is best done through Composer. Assuming that . Through the Composer-based project template by running the command:
composer create-project Vardot/varbase-project YOUR_PROJECT --no-dev --no-interaction
This will create the Varbase project directory that will look like this: /path/to/YOUR_PROJECT
with the Drupal 9 codebase installed via Varbase installation profile in /path/to/YOUR_PROJECT/docroot
.
Updating Varbase should always be done in a local or development environment. Once the update process is properly done and tested you can push your code and build to your production site. DO NOT update Varbase directly when in production.
The Varbase Updater tools requires write permissions to the project directory. Please make sure that the write permissions are active in order for the updater to work.
There are two main update processes we will cover. 1) Automated process using a tool we've developed to ease the update process for Varbase called . 2) Manual process if you wish to take matters into your own hands.
An easy to use automated process is now available. ↓
If you previously used our Composer-based project template to install Varbase , complete the following steps to update your codebase’s installed version of Varbase:
From a command prompt window, navigate to your project: cd /path/to/YOUR_PROJECT
If you're using Varbase 8.6.2 or older, install through Composer. composer require vardot/varbase-updater
If you're using Varbase 8.6.3 or newer, skip this step; comes pre-installed with your Varbase project.
Run the Varbase update tool. ./bin/update-varbase.sh
Follow the wizard.
Curious? about what's going on in the Varbase Updater wizard.
Buy yourself a drink! You're done.
After the update finishes and you get a success message, navigate to (where my.varbase-site.local is the URL for your website) to learn about the new changes and updates introduced in your Varbase site.
From a command prompt window, navigate to the project directory: cd /path/to/YOUR_PROJECT
Edit your composer.json file to be ready for updates. You have two choices.
The easy way:
Then run: composer varbase-refactor-composer composer.new.json docroot
where docroot is your Drupal project codebase.
Move your new Composer file composer.new.json in place of the old one. mv composer.json composer.json.b; \ mv composer.new.json composer.json
Back up the code and database
Execute Composer update to download updates to modules and libraries. composer update
Did you face a problem after the wizard has run? Please report your problem through the .
The hard way: Edit your composer.json to include all the new updates made in . This includes the new components required and its versions "require", "repositories", "extra", and any other important config. You can use a diff tool such as or to help you diff between your old composer.json and the new one from .
If you're using Varbase 8.6.2 or older, install through Composer. composer require vardot/varbase-updater
If you're using Varbase 8.6.3 or newer, skip this step; comes pre-installed with your Varbase project.
Run database updates. drush updatedb
or by navigating to (where my.varbase-site.local is the URL for your website) and follow the on-screen instructions.
After the update finishes with a success message, navigate to (where my.varbase-site.local is the URL for your website) to learn about the new changes and updates introduced in the Varbase site.