# FlowForge

Generated on 4 Jul 2024 from [the FlowForge catalog page](https://marketplace.digitalocean.com/apps/flowforge)

FlowFuse helps Node-RED developers deliver applications in a more reliable, collaborative and secure manner. Node-RED’s intuitive, low-code development environment is great for connecting together hardware devices, APIs and online services. FlowFuse adds to Node-RED, collaborative development, management of remote deployments, support for DevOps deliver pipelines and the ability to host Node-RED applications on FlowFuse Cloud. FlowFuse is the devops platform for Node-RED application development and delivery.

## Before you deploy your FlowForge Droplet

You will need a DNS domain on which to host your FlowForge Node-RED Projects, and be able to create a wildcard DNS entry pointing at the Droplet’s public IP address.

The Digital Ocean [DNS Quickstart](https://docs.digitalocean.com/products/networking/dns/quickstart/index.html.md) will help you get started if you use Digital Ocean to manage your domain.

## Software Included

| Package | Version | License |
|---|---|---|
| [FlowFuse](https://flowfuse.com) | [2.4.0](https://github.com/FlowFuse/flowfuse/releases/tag/v2.4.0) | [Apache 2](https://github.com/flowforge/flowforge/blob/main/LICENSE) |
| Docker CE | [20.10.21](https://docs.docker.com/release-notes/docker-ce/) | [Apache 2](https://github.com/docker/docker/blob/master/LICENSE) |
| Docker Compose | [2.12.0](https://docs.docker.com/release-notes/docker-compose/) | [Apache 2](https://github.com/docker/compose/blob/master/LICENSE) |

## Creating an App using the Control Panel

Click the **Deploy to DigitalOcean** button to create a Droplet based on this 1-Click App. If you aren’t logged in, this link will prompt you to log in with your DigitalOcean account.

[![Deploy to DO](https://www.deploytodo.com/do-btn-blue.svg)](https://cloud.digitalocean.com/droplets/new?image=flowforge)

## Creating an App using the API

In addition to creating a Droplet from the FlowForge 1-Click App using the control panel, you can also use the [DigitalOcean API](https://docs.digitalocean.com/reference/api). As an example, to create a 4GB FlowForge Droplet in the SFO2 region, you can use the following `curl` command. You need to either save your [API access token](https://docs.digitalocean.com/reference/api/create-personal-access-token/index.html.md) to an environment variable or substitute it in the command below.

```shell
curl -X POST -H 'Content-Type: application/json' \
         -H 'Authorization: Bearer '$TOKEN'' -d \
        '{"name":"choose_a_name","region":"sfo2","size":"s-2vcpu-4gb","image":"flowforge"}' \
        "https://api.digitalocean.com/v2/droplets"
```

## Getting Started After Deploying FlowForge

Once the droplet has deployed please do the following:

- Setup a DNS wildcard entry for your domain to point to your\_droplet\_public\_ipv4
- ssh root@your\_droplet\_public\_ipv4

Once logged in you will be asked to enter your domain name, then enter 1 to confirm or 2 to enter the domain name again.

After entering your broker you can complete the setup by pointing your browser at:

- `https://forge.[your domain]/setup`