Command-line Administration

The node-red-admin command-line tool allows you to remotely administer a Node-RED instance.


Install this globally to make the node-red-admin command available on your path:

npm install -g node-red-admin
Note : sudo is required if running as a non-root user on Linux/OS X. If running on Windows, you will need to run in a command shell as Administrator, without the sudo command.

Target and Login

To remotely administer a Node-RED instance, the tool must first be pointed at the Node-RED instance you want it to access. By default, it assumes http://localhost:1880. To change that, use the target command:

node-red-admin target

If authentication is enabled, you must then login:

node-red-admin login

These commands create a file called ~/.node-red/.cli-config.json that stores the target and access token information.

Note : The `hash-pw` option does not require the tool to be logged in and can be run at any time.

Other commands

The tool provides the following commands:

  • list - List all of the installed nodes
  • info - Display more information about the module or node set
  • enable - Enable the specified module or node set
  • disable - Disable the specified module or node set
  • search - Search NPM for Node-RED modules relating to the search-term given
  • install - Install a module from NPM
  • remove - Remove an NPM module
  • hash-pw - Create a password hash that can be used with the adminAuth and httpNodeAuth settings