# node-red-admin

> The Node-RED admin command line interface

Latest version **4.1.7** (published 2026-07-30) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install node-red-admin
pnpm add node-red-admin
yarn add node-red-admin
bun add node-red-admin
```

Provides the command `node-red-admin`.

## Health

**Score 55/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 4.1.7 |
| Published | 2026-07-30 |
| First published | 2015-03-31 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=18 |
| Dependencies | 8 |
| Unpacked size | 126.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 51 |
| Maintainers | knolleary, dceejay |

## Links

- npm: https://www.npmjs.com/package/node-red-admin
- Repository: https://github.com/node-red/node-red-admin
- Homepage: https://nodered.org
- Issues: https://github.com/node-red/node-red-admin/issues/
- npm.io page: https://npm.io/package/node-red-admin

## Dependencies (8)

- [read](https://npm.io/package/read.md) 3.0.1
- [axios](https://npm.io/package/axios.md) 1.19.0
- [bcryptjs](https://npm.io/package/bcryptjs.md) 3.0.3
- [enquirer](https://npm.io/package/enquirer.md) 2.4.1
- [minimist](https://npm.io/package/minimist.md) 1.2.8
- [mustache](https://npm.io/package/mustache.md) 4.2.0
- [cli-table](https://npm.io/package/cli-table.md) 0.3.11
- [ansi-colors](https://npm.io/package/ansi-colors.md) 4.1.3

## Recent versions

- 4.1.7 (latest) — 2026-07-30
- 4.1.6 — 2026-05-06
- 4.1.5 — 2026-04-16
- 4.1.4 — 2026-04-01
- 4.1.3 — 2026-02-11
- 4.1.2 — 2025-10-09
- 4.1.1 — 2025-07-29
- 4.1.0 — 2025-06-10
- 4.0.2 — 2025-04-14
- 4.0.1 — 2024-09-11
- 4.0.0 — 2024-06-17
- 3.1.3 — 2024-03-27
- 3.1.2 — 2024-02-06
- 3.1.1 — 2023-11-17
- 3.1.0 — 2023-09-05
- … 22 more at https://npm.io/package/node-red-admin/versions

## README

# 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.

---
_Source: https://npm.io/package/node-red-admin · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._