# Workbench

Connectware ships with a running Node-RED ([https://nodered.org](https://nodered.org/)) application.

To start working with the prototyping Node-RED Workbench, on the navigation panel click `Services` and on the sidebar, click `Node Red Workbench`. This will open the running Node-RED editor for the Workbench in another browser tab.

<figure><img src="https://3336740149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl5qEJXpPlZtQMoQkkm1p%2Fuploads%2Fgit-blob-378fa0a48c2d7fc89043deac2db2a521f7e61bb0%2Fmenu_item_workbench.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
However, this Node-RED workbench is not intended to be used in production-ready services but rather for quick and easy prototyping tests. In deployments where Node-RED should be used in production, the recommended setup is to create a service commissioning file which installs a Node-RED container as [Cybus::Container resource](https://docs.cybus.io/1-10-0/documentation/services/service-commissioning-files/structure-of-service-commissioning-files/resources/cybus-container) on its own. This way, the authors of the service have the full control over the versioning and life cycle of the Node-RED instance.
{% endhint %}

Further instructions on how to work with Node-RED can be found here: <https://nodered.org/docs>

For connecting the Node-RED flow to the Connectware API, Connectware can be reached by using the server name `connectware` both for MQTT (1883) and HTTPS (443) connections.

<figure><img src="https://3336740149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl5qEJXpPlZtQMoQkkm1p%2Fuploads%2Fgit-blob-575f8a89d817346775e1318e165f7225be3a106d%2Fnodered-mqtt-server.png?alt=media" alt=""><figcaption></figcaption></figure>

Additionally, when subscribing or publishing to the Connectware server, a suitable `username` and `password` has to be set manually in the Node-RED workbench. You need to ensure that the given user has sufficient permissions (or suitable roles) in order to access the topics in question. See also [User Management](https://docs.cybus.io/1-10-0/documentation/user-management).

<figure><img src="https://3336740149-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl5qEJXpPlZtQMoQkkm1p%2Fuploads%2Fgit-blob-2686dae0cd451e368ef10b24b10eafb4e75afaae%2Fnodered-username.png?alt=media" alt=""><figcaption></figcaption></figure>
