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

https://docs.ovh.com/gb/en/dedicated/ssh-introduction/

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.