This project includes:
- Cross-platform support with
mac_start_all.command(macOS),windows_start_all.bat(Windows), andlinux_start_all.sh(Linux) - Automated generation of 10 independent Node-RED instances by default
- A user-friendly launcher experience via double-click files
- A cross-platform reset script to clear every instance back to a clean state
- A minimal structure containing only the files needed to run the launcher
This project allows you to run 10 isolated instances of Node-RED on a single computer, each with its own port and configuration. It's fully cross-platform and portable and works on macOS, Windows, and Linux.
Each instance:
- Runs independently (ports 1990 to 1999)
- Has its own
userDirand flow file - Can be launched via double-click (no terminal knowledge needed)
- Clone the project:
git clone https://github.com/omidteimoori/node-red-multi-launcher.git
- Go into the project folder:
cd node-red-multi-launcher - Install dependencies:
npm install
- Set the maximum number of instances in
Multi-launcher/generate-instances.jsby changingINSTANCE_COUNTif you do not want the default of10. - Apply that change and generate the instance settings:
npm run generate
- Use the launcher for your operating system from the
Multi-launcher/folder.
Running npm install in the project root installs these palettes for every instance:
- FlowFuse Dashboard 2:
@flowfuse/node-red-dashboard - Data Generator:
@omidteimoori/node-red-data-generator - Object Explorer:
@omidteimoori/node-red-object-explorer - OPC UA:
node-red-opcua-otmr
The instances share the installed Node-RED runtime and palettes, while keeping separate flows, credentials, and settings. Add and deploy Dashboard widgets in an instance to create its dashboard.
Security fixes for Node-RED's pinned dependencies are recorded in package.json overrides and package-lock.json. The required npm dependency uses an unbundled upstream archive so its internal libraries can receive these fixes. Its code is unchanged; provenance and rebuild instructions are in vendor/README.md.
To reproduce the checked dependency versions and check for known vulnerabilities:
npm ci
npm audit- After cloning and installing dependencies, set
INSTANCE_COUNTinMulti-launcher/generate-instances.jsif you want a number other than the default10 - Run:
This applies your chosen instance count and generates the settings and folders. By default it creates 10 instances (
npm run generate
instance_0toinstance_9) on ports1990to1999. - Double-click
Multi-launcher/mac_start_all.commandIf double-click does not work, run it from Terminal using the full path to the launcher, for example:/absolute/path/to/node-red-multi-launcher/Multi-launcher/mac_start_all.command
- Open your browser and go to:
- To stop all running instances:
Closing the Terminal window does not stop the detached Node-RED processes.
pkill node-red
- After cloning and installing dependencies, set
INSTANCE_COUNTinMulti-launcher/generate-instances.jsif you want a number other than the default10 - Run:
This applies your chosen instance count and generates the settings and folders. By default it creates 10 instances (
npm run generate
instance_0toinstance_9) on ports1990to1999. - Double-click
Multi-launcher/windows_start_all.bat - Open your browser and go to:
- To stop all running instances:
- Close each
Node-RED <n>Command Prompt window that opened from the launcher, or run:
taskkill /F /FI "WINDOWTITLE eq Node-RED *"
- Close each
- After cloning and installing dependencies, set
INSTANCE_COUNTinMulti-launcher/generate-instances.jsif you want a number other than the default10 - Run:
This applies your chosen instance count and generates the settings and folders. By default it creates 10 instances (
npm run generate
instance_0toinstance_9) on ports1990to1999. - Run:
chmod +x Multi-launcher/linux_start_all.sh ./Multi-launcher/linux_start_all.sh
- Open your browser and go to:
- To stop all running instances:
Closing the terminal that launched the script does not stop the detached Node-RED processes.
pkill node-red
- macOS:
pkill -f 'node_modules/node-red/red.js' - Windows:
taskkill /F /FI "WINDOWTITLE eq Node-RED *"
- Linux:
pkill -f 'node_modules/node-red/red.js'
If you want to reset everything after stopping Node-RED, use one of the reset launchers in Multi-launcher/reset/:
- Windows: double-click
Multi-launcher/reset/windows_reset_all.bat - macOS: double-click
Multi-launcher/reset/mac_reset_all.command - Linux: run
Multi-launcher/reset/linux_reset_all.shdirectly, or double-click it if your desktop is configured to run executable scripts
npm run resetAfter the reset completes, set INSTANCE_COUNT again if needed, then run npm run generate before starting Node-RED again.
nodered-multi/
├── node_modules/ ← Local Node-RED install
├── userDir/ ← Data folders for each instance (instance_0 to instance_9)
├── Multi-launcher/ ← Custom multi-instance launcher files
│ ├── settings/ ← Auto-generated settings files for each instance
│ ├── linux_start_all.sh ← Linux launcher
│ ├── mac_start_all.command ← Double-click entry point for macOS users
│ ├── windows_start_all.bat ← Double-click entry point for Windows users
│ ├── generate-instances.js ← Script to generate userDir/settings structure
│ └── reset/
│ ├── linux_reset_all.sh ← Linux reset launcher
│ ├── mac_reset_all.command ← macOS reset launcher
│ ├── reset_instances.js ← Cross-platform reset script
│ └── windows_reset_all.bat ← Windows reset launcher
├── package.json ← Project dependencies
├── package-lock.json ← Exact dependency versions
├── .gitignore ← Files to ignore in Git (macOS, logs, etc.)
└── LICENSE ← MIT License from original base project
This project is based on TotallyInformation's alternate-node-red-installer.
The original project and core upstream work were created by Julian Knight (Totally Information). This multi-instance launcher keeps that attribution and remains distributed under the MIT License.
This project is licensed under the MIT License.
Original upstream copyright:
- Julian Knight
Additional multi-instance launcher, cross-platform launcher, and reset workflow changes:
- Omid Teimoori
- Node.js 25.9.0
- npm 11.12.1
- macOS, Windows, or Linux
Created by Omid Teimoori
Website | GitHub | LinkedIn
Repository: https://github.com/omidteimoori/node-red-multi-launcher