Registry /
database / node-red-contrib-storage-mongodb
Install & Compatibility
Where this runs
No compatibility data collected yet for this library.
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
mongodbSettings
✓ Add to settings.js: storageModule: require('node-red-contrib-storage-mongodb'), mongodbSettings: { mongoURI: process.env["MONGO_URL"], appname: process.env["APP_NAME"] }
✗ Requiring the module standalone without settings.js configuration
This is a Node-RED storage plugin, not a regular library. It must be configured in Node-RED's settings.js file, not imported in node code.
storageModule
✓ storageModule: require('node-red-contrib-storage-mongodb').default
✗ storageModule: require('node-red-contrib-storage-mongodb')
The package exports a default function in CommonJS. Using require() directly returns the default export; but per Node-RED conventions, assigning directly to storageModule works. In ESM, use import syntax.
none (ESM import)
✓ import storagePlugin from 'node-red-contrib-storage-mongodb'
✗ import { storagePlugin } from 'node-red-contrib-storage-mongodb'
The package exports a default export only. Named imports will fail.
Configures Node-RED to use MongoDB for storing flows, credentials, settings, sessions, and library entries.
// Add to settings.js (usually located in ~/.node-red/)
module.exports = {
// ... other settings
storageModule: require('node-red-contrib-storage-mongodb'),
mongodbSettings: {
mongoURI: process.env.MONGO_URL || 'mongodb://localhost:27017',
appname: process.env.APP_NAME || 'my-node-red'
}
};
// Ensure MongoDB is running and accessible. Start Node-RED.
// The plugin will create collections: flow, credentials, settings, sessions, library
Debug
Known issues
gotchaPackage version 0.0.2 is early and likely unstable. No breaking changes documented because there are few releases.fixMonitor GitHub for updates; consider pinning version if used in production.
affects: <=0.0.2
deprecatedThe package does not specify any deprecated features yet.
breakingNo known breaking changes at this early stage.
Errors
Common errors & fixes
Error: Cannot find module 'node-red-contrib-storage-mongodb'
Package not installed in Node-RED user directory.
fixRun: npm install node-red-contrib-storage-mongodb in your Node-RED user directory (typically ~/.node-red).
MongoNetworkError: failed to connect to server [localhost:27017]
MongoDB not running or wrong URI.
fixStart MongoDB or check the mongoURI in mongodbSettings.
TypeError: Cannot read property 'mongoURI' of undefined
mongodbSettings not defined in settings.js.
fixAdd mongodbSettings object with mongoURI and appname fields.
Audit
Dependencies
No dependency data recorded yet.