# Node-RED

Low-code programming for event-driven applications.

<!-- metadata -->

* **Category**: Apps
* **Status**: 5
* **Image**: [node-red](https://hub.docker.com/r/nodered/node-red/), 4, upstream
* **Healthcheck**: Yes
* **Backups**: Yes
* **Email**: Yes (can be configured with nodes)
* **Tests**: Yes
* **SSO**: Yes

<!-- endmetadata -->

## Quick start

* `abra app new node-red`
* `abra app config <app-name>`
* If you enabled oauth:
    - Set the client secret: `abra app secret insert <app-name> oauth_client_secret v1`
* `abra app deploy <app-name>`

For more, see [`docs.coopcloud.tech`](https://docs.coopcloud.tech).

## Managing dependencies

If you need to install extra [nodes or flows](https://flows.nodered.org/) from npm, you can add them to `EXTRA_MODULES` and they will be installed/updated at startup and persisted. Alternatively, you can set `ENABLE_PROJECTS=true` to use the [projects feature](https://nodered.org/docs/user-guide/projects/) which allows dynamically installing packages.

## Known issues

* Usernames appear as "undefined" when SSO is enabled. This appears to be a bug with the [oauth2 plugin](github.com/jaredhanson/passport-oauth2).