NodeBB: Upgrading to NodeBB v3.x

[mventures]

Hi @phenomlab

I would like to upgrade my current NodeBB installation to the new NodeBB v3.x and use Harmony theme. How do I do this?

[phenomlab]

@mventures As @DownPW stated, stop the NodeBB service from the command line as below, perform the upgrade, then start it up again

./nodebb stop
git fetch && git checkout develop && git reset --hard origin/develop
./nodebb upgrade
./nodebb start

[DownPW]

https://community.nodebb.org/post/92082

[phenomlab]

@mventures As @DownPW stated, stop the NodeBB service from the command line as below, perform the upgrade, then start it up again

./nodebb stop
git fetch && git checkout develop && git reset --hard origin/develop
./nodebb upgrade
./nodebb start

[mventures]

Hey @phenomlab @DownPW Thank you for that “script”. Is that what you call it?

I am on a MacBook and I opened the TERMINAL. Do I just type the script given above? How does the command know to engage with my website, my VPS server, etc? Maybe, there is a step I am missing before typing in these scripts.

[mventures]

@phenomlab

Adding to my last comment, would these my steps be for the UPGRADE part?

1. Open Terminal

2. Paste the script from @DownPW

3. Quit Terminal

4. Then, for the “START IT UP AGAIN” part, how is that done?
   Do I log back in as Admin on my forum, then got to ACP and look for a “start” button?

[phenomlab]

@mventures You’d need to connect to the server and execute it directly - not on your local terminal. Review the guide below, which will show you how to gain access via SSH to your server

Loading...

Please wait while the description loads.

Loading...

Once you have access, you’ll need to navigate to the actual folder where NodeBB is installed

You’ll then need to change to the directory as shown below

/home/unbuntu/nodebb

In most cases, initial access takes you to the root of the file system. You can always issue pwd in a Linux terminal which will show you the Present Working Directory. From there, you can issue the command

cd /home/ubuntu/nodebb

Once in the NodeBB directory, you’d use the below commands

./nodebb stop
git fetch && git checkout develop && git reset --hard origin/develop
./nodebb upgrade
./nodebb start

Line 1 stops the NodeBB instance
Line 2 gets the latest files from GIT (repository) and then checks out the development branch. It then resets the version you are using to the development branch ready for v3
Line 3 Runs the upgrade once the new branch is set, and code pulled
Line 4 Restarts the NodeBB instance after the upgrade has completed

Note that when you restart NodeBB and log back in, things will look very different to what you had in v2.