Skip to content
Sudonix

Setting up a beta NodeBB v3 environment

Moved Let's Build It
14 4 6.3k 1
  • phenomlab phenomlab

    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

    • Type ./nodebb build

    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

    dd590fb2-b062-4c3e-bc81-a4d715583aef-image.png

    • Type git fetch && git pull

    You’ll see the import of a number of changed files

    f0e3575c-b25d-4882-aeaf-5a6007ad984b-image.png

    • Type ./nodebb build && ./nodebb restart

    1039231a-efd0-4def-a2f0-99ee0597866e-image.png

    You can ignore the warnings for now.

    Enjoy the updated instance.

    phenomlab
    phenomlab
    phenomlab
    wrote on
    #2

    @phenomlab Let me know if you come across any issues. Happy to help.

    Mark Cutting also advises organisations as a Fractional CIO, Fractional CISO and Executive Advisor, helping boards improve technology governance, cyber resilience and executive decision making. Learn more at Gratmore Ltd

    3
  • phenomlab phenomlab referenced this topic on
  • phenomlab phenomlab

    @phenomlab Let me know if you come across any issues. Happy to help.

    cagatay
    cagatay
    cagatay
    wrote on
    #3

    @phenomlab anyway this is a beta version, as you said before to me some things not working properly.

    0
  • cagatay cagatay

    @phenomlab anyway this is a beta version, as you said before to me some things not working properly.

    phenomlab
    phenomlab
    phenomlab
    wrote on
    #4

    @cagatay Correct. I’ve adjusted the title accordingly to reflect that.

    Mark Cutting also advises organisations as a Fractional CIO, Fractional CISO and Executive Advisor, helping boards improve technology governance, cyber resilience and executive decision making. Learn more at Gratmore Ltd

    1
  • DownPW
    DownPW
    DownPW
    wrote on
    #5

    I have a Captcha bug after upgrade on login connexion.

    Without that, impossible to connect to nodebb due to captcha bug

    ff6d945e-fccd-46c8-a03a-b924e50a15fb-image.png

    PW and WS Spirit alive

    0
  • DownPW DownPW

    I have a Captcha bug after upgrade on login connexion.

    Without that, impossible to connect to nodebb due to captcha bug

    ff6d945e-fccd-46c8-a03a-b924e50a15fb-image.png

    phenomlab
    phenomlab
    phenomlab
    wrote on
    #6

    @DownPW that’s not a bug as it works fine on my Dev install.

    Screenshot_2023-01-27-21-52-37-75_e4424258c8b8649f6e67d283a50a2cbc.jpg

    Anything in the console?

    Mark Cutting also advises organisations as a Fractional CIO, Fractional CISO and Executive Advisor, helping boards improve technology governance, cyber resilience and executive decision making. Learn more at Gratmore Ltd

    0
  • phenomlab phenomlab

    @DownPW that’s not a bug as it works fine on my Dev install.

    Screenshot_2023-01-27-21-52-37-75_e4424258c8b8649f6e67d283a50a2cbc.jpg

    Anything in the console?

    DownPW
    DownPW
    DownPW
    wrote on
    #7

    @phenomlab I have rebuild and it’s OK now.

    odd but it’s a beta i guess 😉

    PW and WS Spirit alive

    1
  • DownPW
    DownPW
    DownPW
    wrote on
    #8

    Have you have test many plugins ? or have you list of incompatibility plugins for now ?

    PW and WS Spirit alive

    0
  • DownPW DownPW

    Have you have test many plugins ? or have you list of incompatibility plugins for now ?

    phenomlab
    phenomlab
    phenomlab
    wrote on
    #9

    @DownPW I’ve tested most of them. The polls plugin doesn’t seem to work from what I can see but others are fully functional. I need to perform a full audit though as I’ve mostly focused on the Swatch code.

    Mark Cutting also advises organisations as a Fractional CIO, Fractional CISO and Executive Advisor, helping boards improve technology governance, cyber resilience and executive decision making. Learn more at Gratmore Ltd

    1
  • DownPW
    DownPW
    DownPW
    wrote on
    #10

    and you upgrade via cli your plugin ?

    I have this with acp on all plugins to update :

    ee3f0fed-b829-45d5-a442-4b17b6bcbfb2-image.png

    2023-01-27T22:02:49.046Z [4567/1606] - error: admin.plugins.upgrade
Error: Command failed: npm install nodebb-plugin-tenor-gif@3.0.0 --save
npm ERR! code ERESOLVE
npm ERR! ERESOLVE could not resolve
npm ERR! 
npm ERR! While resolving: @nodebb/nodebb-plugin-reactions@1.0.2
npm ERR! Found: nodebb-plugin-emoji@5.0.3
npm ERR! node_modules/nodebb-plugin-emoji
npm ERR!   peer nodebb-plugin-emoji@"^5.0.0" from nodebb-plugin-emoji-android@4.0.0
npm ERR!   node_modules/nodebb-plugin-emoji-android
npm ERR!     nodebb-plugin-emoji-android@"4.0.0" from the root project
npm ERR!   nodebb-plugin-emoji@"5.0.3" from the root project
npm ERR! 
npm ERR! Could not resolve dependency:
npm ERR! peer nodebb-plugin-emoji@"^4.0.0" from @nodebb/nodebb-plugin-reactions@1.0.2
npm ERR! node_modules/@nodebb/nodebb-plugin-reactions
npm ERR!   @nodebb/nodebb-plugin-reactions@"^1.0.2" from the root project
npm ERR! 
npm ERR! Conflicting peer dependency: nodebb-plugin-emoji@4.0.6
npm ERR! node_modules/nodebb-plugin-emoji
npm ERR!   peer nodebb-plugin-emoji@"^4.0.0" from @nodebb/nodebb-plugin-reactions@1.0.2
npm ERR!   node_modules/@nodebb/nodebb-plugin-reactions
npm ERR!     @nodebb/nodebb-plugin-reactions@"^1.0.2" from the root project
npm ERR! 
npm ERR! Fix the upstream dependency conflict, or retry
npm ERR! this command with --force, or --legacy-peer-deps
npm ERR! to accept an incorrect (and potentially broken) dependency resolution.
npm ERR! 
npm ERR! See /root/.npm/eresolve-report.txt for a full report.

npm ERR! A complete log of this run can be found in:
npm ERR!     /root/.npm/_logs/2023-01-27T22_02_45_967Z-debug-0.log

    at ChildProcess.exithandler (node:child_process:419:12)
    at ChildProcess.emit (node:events:513:28)
    at maybeClose (node:internal/child_process:1091:16)
    at ChildProcess._handle.onexit (node:internal/child_process:302:5)
    at Process.callbackTrampoline (node:internal/async_hooks:130:17)

    Exemple here for update this plugin must to test :

    npm install nodebb-plugin-tenor-gif@3.0.0

    ?

    PW and WS Spirit alive

    0
  • DownPW DownPW

    and you upgrade via cli your plugin ?

    I have this with acp on all plugins to update :

    ee3f0fed-b829-45d5-a442-4b17b6bcbfb2-image.png

    2023-01-27T22:02:49.046Z [4567/1606] - error: admin.plugins.upgrade
Error: Command failed: npm install nodebb-plugin-tenor-gif@3.0.0 --save
npm ERR! code ERESOLVE
npm ERR! ERESOLVE could not resolve
npm ERR! 
npm ERR! While resolving: @nodebb/nodebb-plugin-reactions@1.0.2
npm ERR! Found: nodebb-plugin-emoji@5.0.3
npm ERR! node_modules/nodebb-plugin-emoji
npm ERR!   peer nodebb-plugin-emoji@"^5.0.0" from nodebb-plugin-emoji-android@4.0.0
npm ERR!   node_modules/nodebb-plugin-emoji-android
npm ERR!     nodebb-plugin-emoji-android@"4.0.0" from the root project
npm ERR!   nodebb-plugin-emoji@"5.0.3" from the root project
npm ERR! 
npm ERR! Could not resolve dependency:
npm ERR! peer nodebb-plugin-emoji@"^4.0.0" from @nodebb/nodebb-plugin-reactions@1.0.2
npm ERR! node_modules/@nodebb/nodebb-plugin-reactions
npm ERR!   @nodebb/nodebb-plugin-reactions@"^1.0.2" from the root project
npm ERR! 
npm ERR! Conflicting peer dependency: nodebb-plugin-emoji@4.0.6
npm ERR! node_modules/nodebb-plugin-emoji
npm ERR!   peer nodebb-plugin-emoji@"^4.0.0" from @nodebb/nodebb-plugin-reactions@1.0.2
npm ERR!   node_modules/@nodebb/nodebb-plugin-reactions
npm ERR!     @nodebb/nodebb-plugin-reactions@"^1.0.2" from the root project
npm ERR! 
npm ERR! Fix the upstream dependency conflict, or retry
npm ERR! this command with --force, or --legacy-peer-deps
npm ERR! to accept an incorrect (and potentially broken) dependency resolution.
npm ERR! 
npm ERR! See /root/.npm/eresolve-report.txt for a full report.

npm ERR! A complete log of this run can be found in:
npm ERR!     /root/.npm/_logs/2023-01-27T22_02_45_967Z-debug-0.log

    at ChildProcess.exithandler (node:child_process:419:12)
    at ChildProcess.emit (node:events:513:28)
    at maybeClose (node:internal/child_process:1091:16)
    at ChildProcess._handle.onexit (node:internal/child_process:302:5)
    at Process.callbackTrampoline (node:internal/async_hooks:130:17)

    Exemple here for update this plugin must to test :

    npm install nodebb-plugin-tenor-gif@3.0.0

    ?

    DownPW
    DownPW
    DownPW
    wrote on
    #11

    @phenomlab

    Ok like pitaj said on nodebb communauty i have test this :

    npm config set legacy-peer-deps true

    and the plugins is installed without error on ACP

    Maybe add this on your first topic 😉

    PW and WS Spirit alive

    0
  • DownPW DownPW

    @phenomlab

    Ok like pitaj said on nodebb communauty i have test this :

    npm config set legacy-peer-deps true

    and the plugins is installed without error on ACP

    Maybe add this on your first topic 😉

    phenomlab
    phenomlab
    phenomlab
    wrote on
    #12

    @DownPW good call. Will get that added.

    Mark Cutting also advises organisations as a Fractional CIO, Fractional CISO and Executive Advisor, helping boards improve technology governance, cyber resilience and executive decision making. Learn more at Gratmore Ltd

    0
  • dave1904
    dave1904
    dave1904
    wrote on
    #13

    Thanks for the guide, got my v3 environment running. 🙂

    1
  • dave1904 dave1904

    Thanks for the guide, got my v3 environment running. 🙂

    phenomlab
    phenomlab
    phenomlab
    wrote on
    #14

    @dave1904 excellent news. Thanks for the feedback

    Mark Cutting also advises organisations as a Fractional CIO, Fractional CISO and Executive Advisor, helping boards improve technology governance, cyber resilience and executive decision making. Learn more at Gratmore Ltd

    0
  • phenomlab phenomlab moved this topic from Guides on
Log in to reply

Related Topics
  • cagatay

    NodeBB v4.0.0

    General nodebb sudonix version 4
    28
    4 Votes
    28 Posts
    8k Views
    phenomlab
    @Panda said in NodeBB v4.0.0: the workings of World aren’t intuitive Its not easy to get World populating when a forum is new to it This is a good point and one I’ve considered also. It’s a little confusing to be honest.
  • Panda

    Nodebb and emails

    Solved Configure nodebb
    27
    5 Votes
    27 Posts
    10k Views
    phenomlab
    @Panda it will use SMTP. In all cases, I never use any plugin to send email. I’ll always send it raw.
  • crazycells

    CSS codes to prevent votes to disappear

    Solved Customisation nodebb
    3
    1 Votes
    3 Posts
    1k Views
    crazycells
    @phenomlab yes, it is thanks a lot…
  • DownPW

    Material View Support for Stock NodeBB

    Unsolved Let's Build It material view javascript css
    51
    4
    15 Votes
    51 Posts
    27k Views
    DownPW
    Oh yes, that’s what’s super cool, I learn something every day. Afterwards I start from so low in JS
  • phenomlab

    Threaded post support for NodeBB

    Let's Build It threading nodebb
    146
    3
    50 Votes
    146 Posts
    116k Views
    phenomlab
    Updated git for above change https://github.com/phenomlab/nodebb-harmony-threading/commit/14a4e277521d83d219065ffb14154fd5f5cfac69
  • phenomlab

    v3 & Harmony diary / thoughts / code snippets

    Announcements harmony v3.beta1 nodebb
    55
    5
    36 Votes
    55 Posts
    30k Views
    phenomlab
    @DownPW I see why. The code relies on the existence of [component="topic/quickreply/container"] However, this by definition means that the below has to be enabled [image: aeef638f-4188-489d-a9f2-f3a26dbca9d8-image.png] It will then work [image: 7fb38631-e0f3-46ef-b652-00929d927b13-image.png] For some unknown reason, this is hidden in Harmony, and only shows if you select it. In v2, it seems that the <section> is deleted altogether in Persona if “Quick Reply” is disabled, meaning it won’t fire as it can’t locate that specific component. The downside is that you might not want the quick reply function, but I think it’s a PITA to scroll up to the top of the post just to reply, so I have it on
  • cagatay

    NodeBB v3

    Announcements nodebb v3 nodebb
    2
    3 Votes
    2 Posts
    1k Views
    phenomlab
    @cagatay JS will work fine - no changes there, and there are no plans to drop support for jQuery. More of an issue is the CSS - for which there are quite a few breaking changes. Keep an eye on sudonix.dev (my development site) where you can see progress in relation to how I am tackling the compatibility issues.
  • Panda

    Adding fileWrite to nodebb code

    Solved Configure nodebb
    16
    1
    5 Votes
    16 Posts
    5k Views
    phenomlab
    @eveh this might be a question for the NodeBB Devs themselves. In all honesty, I’m not entirely sure without having to research this myself.