Flux Node Network Setup

Created by John K, Modified on Sat, 03 Dec 2022 at 10:42 PM by John K

To ensure proper operation of your Flux Node please be sure to setup your networking appropriately. Below we will cover single and multi-node network requirements.

Single Node

Single node setups can use UPNP or Port Forwarding. The most simplistic is port forwarding. Port Forwarding is where you enable rules on the router to pass specific incoming traffic to the node's local IP.

For port forwarding to work properly you will need to setup a static or dhcp reservation for your node on the local network. This is done differently depending on your router. Static or dhcp reservation makes it so your node will always have the same local IP address on your network.

Port Forwarding for Single Node


UPNP Setup for Single Node

UPNP stands for universal plug and play which essentially allows devices on your network to request ports to be opened by your router for incoming traffic. UPNP can be an easier solution if your router is supported and sticks to proper upnp standards.

To setup upnp on your router you will first need to set your node to a static or or dhcp reservation so your local IP for you node always stays the same. Next you will need to remove any port forwarding that you have setup for you node (if any). Finally you will want to enable upnp and reboot your router before proceeding to the next step.

To enable upnp on your Flux node you will need to run multitoolbox option 14 and select an API port for your node. I typically suggest starting from the lowest port and working your way up. The lowest port is 16127.

Multi-node Configuration

The maximum number of Flux nodes supported on a single external IP address is 8.

UPNP is REQUIRED to run more than a single node on the same external IP address. Port Forwarding WILL NOT work properly on most consumer grade routers.

The UPNP setup is exactly the same as a single node setup except when you run multitoolbox option 14 you will want to choose a different API port for each node. Also, please be sure to set each node to a static or dhcp reservation in your router settings.

Network Diagnostic Tools

After you have installed your node and you are going through the final stages to make sure the node is ready to be started in Zelcore, you will want to ensure your ports are open from the outside.

There is a simple command line tool that you can use to test your ports and upnp status all at once. If ports show as closed you will want to investigate your networking setup.

bash -i <(curl -s https://raw.githubusercontent.com/JKTUNING/Flux-Node-Tools/main/flux_node_viewer.sh node)

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select atleast one of the reasons

Feedback sent

We appreciate your effort and will try to fix the article