Create RLN Node

Provision a new RGB Lightning Node on the Utexo Cloud dashboard.

Prerequisites

Before creating a node, ensure you have:

1. An active Utexo Cloud account at cloud.utexo.com
2. A Cloud API token (required for API-based operations)

Steps

1. Initiate Node Creation

Navigate to the /nodes page. You will see an overview of your current nodes and the option to create new ones.

Click the Create Node button to open the node creation form.

2. Configure Your RLN Node

Enter a unique name for your new node. This name identifies the node in your dashboard.

Click Create to submit the form and begin provisioning.

3. Monitor Node Creation Status

After submitting, a new entry appears in the nodes table with a status of IN_PROGRESS. During this phase, no operations can be performed on the node.

Visit /nodes/{nodeId} to view detailed information: current status, build progress, endpoint details, and configuration options.

Status	Meaning
IN_PROGRESS	Node is under construction. No interactions are available.
RUNNING	Node is fully operational.
PAUSED	Node has been paused.
FAILED	Node encountered an error during provisioning.

4. Final Verification

Once the status changes to RUNNING, verify the node appears correctly in your dashboard and that you can access its features and settings.

After a node reaches RUNNING status, connect to it via mTLS or API token. See Connect to RLN Node for details.

Regtest Network (Testing Only)

The following applies only to nodes on the Regtest network for development and testing. Do not use these commands on Mainnet nodes.

On Regtest, blocks are not mined automatically. Use your node’s Bitcoin Core RPC endpoint to advance the chain manually.

To mine blocks:

curl --location '{YOUR_NODE_RPC_ENDPOINT}/execute' \
  --header 'Content-Type: application/json' \
  --data '{ "args": "mine 10" }'

To get test BTC (local faucet), send to an address and mine a block to confirm:

curl --location '{YOUR_NODE_RPC_ENDPOINT}/execute' \
  --header 'Content-Type: application/json' \
  --data '{ "args": "sendtoaddress <address> 0.1" }'

Replace {YOUR_NODE_RPC_ENDPOINT} with the RPC endpoint visible on your node’s dashboard page.