webservices/node_modules/node-red-admin/README.md

49 lines
1.9 KiB
Markdown

# Node-RED Admin CLI
The Node-RED admin command line interface.
[![Tests](https://github.com/node-red/node-red-admin/actions/workflows/tests.yml/badge.svg)](https://github.com/node-red/node-red-admin/actions/workflows/tests.yml) [![Coverage Status](https://coveralls.io/repos/node-red/node-red-admin/badge.svg?branch=master)](https://coveralls.io/r/node-red/node-red-admin?branch=master)
A command line tool for remotely administering Node-RED.
It is built into `node-red` and can be run as:
node-red admin ....
## Standalone install
Install this globally to make the `node-red-admin` command available on your path:
npm install -g node-red-admin
Note: you may need to run this with `sudo`, or from within an Administrator command shell.
You may also need to add `--unsafe-perm` to the command if you hit permissions errors during installation.
## Usage
Usage:
node-red-admin <command> [args] [--help] [--userDir DIR] [--json]
Description:
Node-RED command-line client
Commands:
target - Set or view the target URL and port like http://localhost:1880
login - Log user in to the target of the Node-RED admin API
list - List all of the installed nodes
info - Display more information about the module or node
enable - Enable the specified module or node set
disable - Disable the specified module or node set
search - Search for Node-RED modules to install
install - Install the module from NPM to Node-RED
remove - Remove the NPM module from Node-RED
hash-pw - Creates a hash to use for Node-RED settings like "adminAuth"
By default, the tool stores its configuration in `~/.node-red/.cli-config.json`. You
can specify a different directory for the config file using the `--userDir` argument.
The `--json` option causes the tool to format its output as JSON making it suitable
for scripting.