{"id":43460,"library":"node-red-contrib-storage-mongodb","title":"Node-RED MongoDB Storage Plugin","description":"A storage plugin for Node-RED that uses MongoDB to persist flows, credentials, settings, sessions, and library entries. Current version: 0.0.2. This is an early-stage, experimental package with low release cadence. It replaces Node-RED's default file-based storage with a MongoDB backend, enabling centralized storage for distributed Node-RED instances. Key differentiator: supports multiple Node-RED instances sharing the same MongoDB database via an 'appname' identifier. Alternative to node-red-contrib-mongodb or custom storage solutions.","status":"active","version":"0.0.2","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","node-red","mongodb","node-red-storage"],"install":[{"cmd":"npm install node-red-contrib-storage-mongodb","lang":"bash","label":"npm"},{"cmd":"yarn add node-red-contrib-storage-mongodb","lang":"bash","label":"yarn"},{"cmd":"pnpm add node-red-contrib-storage-mongodb","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"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.","wrong":"Requiring the module standalone without settings.js configuration","symbol":"mongodbSettings","correct":"Add to settings.js: storageModule: require('node-red-contrib-storage-mongodb'), mongodbSettings: { mongoURI: process.env[\"MONGO_URL\"], appname: process.env[\"APP_NAME\"] }"},{"note":"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.","wrong":"storageModule: require('node-red-contrib-storage-mongodb')","symbol":"storageModule","correct":"storageModule: require('node-red-contrib-storage-mongodb').default"},{"note":"The package exports a default export only. Named imports will fail.","wrong":"import { storagePlugin } from 'node-red-contrib-storage-mongodb'","symbol":"none (ESM import)","correct":"import storagePlugin from 'node-red-contrib-storage-mongodb'"}],"quickstart":{"code":"// Add to settings.js (usually located in ~/.node-red/)\nmodule.exports = {\n  // ... other settings\n  storageModule: require('node-red-contrib-storage-mongodb'),\n  mongodbSettings: {\n    mongoURI: process.env.MONGO_URL || 'mongodb://localhost:27017',\n    appname: process.env.APP_NAME || 'my-node-red'\n  }\n};\n// Ensure MongoDB is running and accessible. Start Node-RED.\n// The plugin will create collections: flow, credentials, settings, sessions, library","lang":"javascript","description":"Configures Node-RED to use MongoDB for storing flows, credentials, settings, sessions, and library entries."},"warnings":[{"fix":"Monitor GitHub for updates; consider pinning version if used in production.","message":"Package version 0.0.2 is early and likely unstable. No breaking changes documented because there are few releases.","severity":"gotcha","affected_versions":"<=0.0.2"},{"fix":"","message":"The package does not specify any deprecated features yet.","severity":"deprecated","affected_versions":""},{"fix":"","message":"No known breaking changes at this early stage.","severity":"breaking","affected_versions":""}],"env_vars":null,"search_vec":"'0.0.2':28 'altern':82 'appnam':80 'backend':55 'base':50 'cadenc':40 'central':57 'contrib':87 'credenti':20 'current':26 'custom':90 'databas':77 'default':47 'differenti':66 'distribut':60 'earli':33 'early-stag':32 'enabl':56 'entri':25 'experiment':35 'file':49 'file-bas':48 'flow':19 'identifi':81 'instanc':64,72 'javascript':93 'key':65 'librari':24 'low':38 'mongodb':4,16,54,76,88,97 'multipl':68 'node':2,12,44,62,70,85,95,99 'node-r':1,11,43,61,69,94 'node-red-contrib-mongodb':84 'node-red-storag':98 'packag':36 'persist':18 'plugin':6,9 'red':3,13,45,63,71,86,96,100 'releas':39 'replac':42 'session':22 'set':21 'share':73 'solut':92 'stage':34 'storag':5,8,51,58,91,101 'support':67 'use':15 'version':27 'via':78","created_at":"2026-06-05T16:59:54.755020+00:00","updated_at":"2026-06-05T16:59:54.755020+00:00","problems":[{"fix":"Run: npm install node-red-contrib-storage-mongodb in your Node-RED user directory (typically ~/.node-red).","cause":"Package not installed in Node-RED user directory.","error":"Error: Cannot find module 'node-red-contrib-storage-mongodb'"},{"fix":"Start MongoDB or check the mongoURI in mongodbSettings.","cause":"MongoDB not running or wrong URI.","error":"MongoNetworkError: failed to connect to server [localhost:27017]"},{"fix":"Add mongodbSettings object with mongoURI and appname fields.","cause":"mongodbSettings not defined in settings.js.","error":"TypeError: Cannot read property 'mongoURI' of undefined"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":null,"npm":"node-red-contrib-storage-mongodb","openapi_spec":null,"status_page":null,"smithery":null,"categories":["database"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-05","next_check":"2026-09-03","install_tag":null}}