v4.0.0 Upgrade Support

julian

If you have problems upgrading to v4.0.0, you can ask for help here.

karsten13

Hi,

I plan upgrading to v4 and tested the new version locally getting these warnings:

2025-01-22T21:37:20.474Z [4567/233] - warn: [plugins/load] The following plugins may not be compatible with your version of NodeBB. This may cause unintended behaviour or crashing. In the event of an unresponsive NodeBB caused by this plugin, run `./nodebb reset -p PLUGINNAME` to disable it.
  * nodebb-plugin-2factor
  * nodebb-plugin-composer-default
  * nodebb-plugin-dbsearch
  * nodebb-widget-essentials
  * nodebb-plugin-custom-pages
  * nodebb-plugin-recent-cards
  * nodebb-plugin-question-and-answer
  * nodebb-rewards-essentials
  * nodebb-plugin-spam-be-gone

After digging in the code I found that the plugins define compatibility in their package.json

  "nbbpm": {
    "compatibility": "^3.0.0"
  },

So I did some debug logging:

'nodebb-theme-persona ^4.0.0'
'nodebb-plugin-2factor ^3.8.0'
'nodebb-plugin-composer-default ^3.0.0'
'nodebb-plugin-dbsearch ^3.3.0'
'nodebb-widget-essentials ^3.0.0'
'nodebb-plugin-custom-pages ^3.2.0'
'nodebb-plugin-recent-cards ^3.7.0'
'nodebb-plugin-mentions ^4.0.0'
'nodebb-plugin-markdown ^4.0.0'
'nodebb-plugin-emoji ^4.0.0'
'nodebb-plugin-question-and-answer ^3.6.3'
'nodebb-rewards-essentials ^3.5.0'
'nodebb-plugin-spam-be-gone ^3.0.0'

Most incompatible plugins are delivered with core nodebb.

My question: Is it safe to upgrade to v4? Waiting for compatibility updates of the plugins could take long ...

Thanks!

<baris>

All those plugins are likely working with 4.x we just need to release new versions after updating the compatibility string. 4.x didn't have plugin breaking changes like 3.x did.

julian

@baris @karsten13 agreed, all of those plugins should be working fine with latest NodeBB