Users can use a remote node on their network or outside of their network by creating an SSH tunnel into that system. Below is how to do this from a Linux system but you can also do the same from a PowerShell on Windows or from the Terminal on MacOS.

If the system you run your node on uses a software firewall like UFW, you'll need to enable port 22 for SSH access.

For outside network connections, use the external IP address where the node is located. You will also need to open the SSH port on your firewall which is typically port 22.

Use the following Terminal command to establish the tunnel:

ssh -L 12398:localhost:12391 [email protected]

The first port number can be any port as long as it matches what you configure in the CHOOSE CUSTOM NODE settings, we have chosen 12398 in this example. The second port number needs to be 12391. The username and IP address to the computer will depend on your unique setup.

Upon first connecting it will ask you if you want to trust the encrypted fingerprint. Type 'yes' and press enter. Then proceed with the username's password.

Once logged in, you will see the system's name and the username you logged in with in the terminal. This is a great way to also manage a remote node from the command line. You need to keep this terminal window open to keep the tunnel active.

Now you need to open up Qortal Hub and configure the CHOOSE CUSTOM NODE settings.

Once inside the CHOOSE CUSTOM NODE settings, click ADD

Then add the localhost node IP address with the port number as shown. The port number needs to match the first port number you tunneled into your node with. Add the API Key which is found in your ~/qortal directory in a text file called apikey.txt On Windows, the API Key file is found in C:\Program Files\Qortal When the information is entered, click SAVE.

Your chosen node will have the CHOOSE button greyed out. Then click CLOSE.

Now you can log in as normal with either a saved account or a new account. Make sure your localhost IP address you configured shows up where it says 'Using node:…'

Upon logging in, you can mouse over the Qortal icon in the top left corner to see which node you're currently connected to.