With NodeBB v3 on the horizon, I thought it would make sense for me to provide a guide on how to upgrade an existing (or newly built - up to you) environment to v3.beta1
This guide assumes you already have a v2 test environment functional and are looking to upgrade to v3.
Let’s start:
First, ensure your nodebb
instance has been stopped
- Type
npm config set legacy-peer-deps true
- cd /path/to/your/nodebb
- Type
git rev-parse HEAD
(save this value in case you need to roll back)
- Type
git fetch && git checkout bootstrap5
- Type
git reset --hard v3.0.0-beta.1
- Type
./nodebb upgrade -mi
Now upgrade all your plugins to the latest version if available
As this will be a beta
system, there will be frequent updates for the Harmony theme which will present themselves in the usual place (ACP -> Install Plugins - Out of Date). These should be installed in the usual fashion, although along with these updates, you will need to perform a git fetch
and git pull
of the bootstrap5
repository as it will shown as several releases behind.
Once you’ve updated the Harmony theme as below
- Type
git fetch && git pull
You’ll see the import of a number of changed files
- Type
./nodebb build && ./nodebb restart
You can ignore the warnings for now.
Enjoy the updated instance.