Qortal Project

The future of blockchain platforms

User Tools

Site Tools


Sidebar

Qortal Project Wiki

Important Notices

Introduction

Project Model

Minting

Communications

Trade Portal

Qortal Hosting (QDN)

Voting System

AT System

Hardware

Frequently Asked Questions (FAQ)

How-To Guides

Node Setup Guides

Third-Party Services

port_forwarding

This is an old revision of the document!


Port Forwarding

Port forwarding can be necessary for helping your node stay synced and connected to peers. This can increase connections/peers for your Qortal core node(s). We will try to make this scenario as simple as we can - as there are several variables. Choose the section below that fits your situation:

Only One Node On Your Home Network With uPnP Enabled

Option 1: In this case, you only have ONE device that is acting as a blockchain node for Qortal AND your router has uPnP enabled. The default settings that your node will have comes with uPnP enabled - uPnP is a feature that most common routers provide by default. If you are unsure, ask your service provider. With uPnP enabled in the router, and only ONE node running on your home network, you do NOT need to configure anything further on this guide.

Option 2: If your router does NOT offer uPNP, you will need to port forward AND disable the default uPnP in your settings.json:

1) Stop the core:

cd qortal && ./stop.sh

2) Open your settings.json - this may be blank which indicates you have the default settings. You will then copy and paste the code below into the settings.json and click save:

{
"uPnPEnabled": false,
"listenPort": 12392
}

If you have settings already displayed, look for the uPnPEnabled section, if it exists, simply replace 'true' with 'false'. Then add the listenPort as shown above below uPnPEnabled section (or anywhere within the json settings as it doesn't have to be in a particular order - just be sure to add a comma after each listing, and DO NOT have a comma on the final listing.

3) Login to your router and set the IP address of the node to "STATIC" or "Reserve IP Address" or whatever verbiage your router uses for this setting. This will prevent the node’s IP address from changing and affecting all of this configuration.

4) In your router, configure port forwarding for this device: Inbound: 12392 (sometimes ‘inbound’ is titled ‘internal’) Outbound 12392 (sometimes ‘outbound’ is titled ‘external’) Protocol: TCP

5) Start your core:

cd qortal && ./start.sh

More Than One Node On Your Home Network

If you have more than one node on your network, then you’ll want to disable uPnP:

  • Set a static IP address for each node in the router.
  • Configure port forwarding in the router for each node.
  • Stop the core, then change the json settings on each node to disable uPnP.
  • Start the core on each node.

1) Login to your router and disable uPnP (if your router has this option).

2) Set the IP address of each node to STATIC. This will prevent the node’s IP address from changing and affecting all of this configuration.

3) Set port forwarding for each node as shown in the following. Internal and external for each node will be unique and NOT match the other nodes:

Node 1 Internal: 12392 External: 12392

Node 2 Internal: 12393 External: 12393

Node 3 Internal: 12394 External: 12394

Node 4 Internal: 12395 External: 12395

etc.

(Just change the last digit in each number.)

4) Stop the core by entering the following command in the terminal:

cd qortal && ./stop.sh

Open your settings.json - this may be blank which indicates you have the default settings. You will then copy and paste the code below into the settings.json and click save:

{
"uPnPEnabled": false,
"listenPort": 12392
}

If you have settings already displayed, look for the uPnPEnabled section, if it exists, simply replace 'true' with 'false'. Then add the listenPort as shown above below uPnPEnabled section (or anywhere within the json settings as it doesn't have to be in a particular order - just be sure to add a comma after each listing, and DO NOT have a comma on the final listing.

5) Start the core on each node:

cd qortal && ./start.sh

Third Party Guides

Here you can find step by step info for specific router: https://portforward.com/

Static IP guide: https://www.coolblue.nl/en/advice/assign-fixed-ip-address-router.html

Port forwarding guide: https://www.lifewire.com/how-to-port-forward-4163829

How to Port Forward with Advanced Settings

It is never a good idea to add your node in DMZ. That will stop all the DPI and SPI and if you have the API enabled and white listed, you are putting your computer at risk! DMZ bypasses the SPI mechanism of the built in filters and all the internet traffic can reach your node directly. SPI (stateful packet inspection) firewall protects you by examining incoming packets against existing connections. Also add UPnP text. If a router has it then it must be enabled. UPnP or NAT-pmp opens dynamic port ranges to act as an assist for SPI. Enabling NAT/UPnP solves problem for the most but unfortunately due to the torrent p2p laws most ISPs now filter ports by default at the client side so port forward is also needed. For example:

219.88.183.49:12392 (qortal-1.2.3-2df0453), height 42318, sig: PXNoJM7W, ts 2020-07-31 17:17:24

192.168.100.83:44380 (qortal-1.2.3-2df0453), height 42318, sig: PXNoJM7W, ts 2020-07-31 17:17:24

Look at the second IP address with a dynamic port. This is UPnP working. Instead of 12392 , it has opened a 44380 port for TCP handshake / connect / ACK.

port_forwarding.1675107448.txt.gz · Last modified: 01/30/2023 14:37 by gisele_h