Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslnode 18–226 runs
build_error
glibcnode 18–226 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
AQ_Node
✓ const AQ_Node = require('node-red-aquila').AQ_Node
✗ import { AQ_Node } from 'node-red-aquila'
Node-RED environments typically use CommonJS require() in Node.js.
aquilaNode
✓ const { aquilaNode } = require('node-red-aquila')
✗ const aquilaNode = require('node-red-aquila')
Be careful to destructure if only one is needed.
default
✓ const Aquila = require('node-red-aquila')
✗ import Aquila from 'node-red-aquila'
The package exports a namespace object, not a default export.
Shows how to manually register an Aquila node type in Node-RED using CommonJS require and registerType.
// In Node-RED function node or settings.js
const Aquila = require('node-red-aquila');
// Node-RED will auto-discover nodes if installed correctly.
// Manual registration example:
RED.nodes.registerType('aquila-out', Aquila.aquilaNode);
Errors
Common errors & fixes
Error: Cannot find module 'node-red-aquila'
Node-RED cannot locate the package; likely installed in wrong directory or not installed.
fixEnsure npm install is run from ~/.node-red directory.
TypeError: RED.nodes.registerType is not a function
Trying to use registerType outside of Node-RED context or before RED is available.
fixUse registerType only in Node-RED settings.js or within a Node-RED plugin context.
Error: The module 'node-red-aquila' is not a Node-RED module
Node-RED failed to load the module because it lacks proper package.json node-red section.
fixEnsure package.json contains 'node-red' key with nodes array.
Audit
Dependencies
node-redoptionalRuntime dependency; nodes are loaded by Node-RED