- docs
- Overview
- Administering FlowForge
- Contributing to FlowForge
- FlowForge API
- FlowForge Cloud
- Using FlowForge
- Changing the Stack
- devices
- Environment Variables
- FlowForge Concepts
- FlowForge File Nodes
- FlowForge Persistent Context
- FlowForge Project Nodes
- Instance Settings
- Logging
- Migrating a Node-RED project to FlowForge
- Node-RED Tools plugin
- Shared Team Library
- Snapshots
- Staged Deployments
- Teams
- Running FlowForge
- Installing FlowForge
- Configuring FlowForge
- DNS Setup
- Docker install
- Email configuration
- First Run Setup
- FlowForge File Storage
- Install FlowForge on Kubernetes
- Local Install
- Upgrading FlowForge
# Local Stacks
A Stack defines a set of platform configuration options that will get applied to each Node-RED instance when it is created.
For the Local deployment model, this covers two things:
memory- the value to apply (in MB) to the Node.jsmax-old-space-sizeoption. This defines the point where Node.js will start freeing unused memory. It is not a hard limit - Node-RED's memory usage will not be capped - but this is useful when running on a memory constrained device such as a Raspberry Pi. Recommended minimum256.nodered- the version number of Node-RED to use. This should match the value used in the steps following.
The FlowForge installer will create a default stack using the latest stable release of Node-RED.
The stacks are stored under /opt/flowforge/var/stacks or c:\flowforge\var\stacks on Windows.
# Creating a Stack
When a new version of Node-RED is released, it can be added to your FlowForge platform by creating a new stack.
For a local install there are two steps required:
-
Install a new Node-RED version
In the FlowForge Home directory, run the provided install script. You must provide the full Node-RED version number, eg
3.0.2, or uselatestto install the most recent stable version.Linux/Mac:
cd /opt/flowforge
./bin/ff-install-stack.sh 3.0.2Windows
cd c:\flowforge
bin\ff-install-stack.bat 3.0.2 -
Creating the Stack
Log into the FlowForge platform as an administrator. Navigate to the Admin Settings -> Stacks section.
If this new stack should be offered as a direct upgrade of an existing stack, select the 'Create new version' option from the dropdown menu of the stack you want to replace. Node-RED instances that use the old stack will offer the new stack as a one-click upgrade option.
Alternatively, click 'Create stack' to create an entirely new stack.
When prompted for the Node-RED version, provide the exact version that was installed. For example, if you ran the script with
latestand it resulted in3.0.2being installed, you should enter3.0.2. This must match the directory name created in yourstacksdirectory.
# Development Only
If you are developing FlowForge having checked it out from GitHub then you can run the following command in the repository root to install a stack:
npm run install-stack --vers=3.0.2