Running a Headless Node


Windows / OSX / Linux

IMPORTANT!

The newest recommended IRI version is 1.2.0 and can be found here:
https://github.com/iotaledger/iri/releases/tag/v1.2.0

How to run a Headless Node on Windows

First, download the IRI-*version_number*.jar file to your computer, remembering where you saved it.

The latest version is: https://github.com/iotaledger/iri/releases/tag/v1.2.0



In the same directory as the IRI-*version_number*.jar create a new .txt file.



Select 'File > Save As' and in the 'Save As' window, input a name for your file adding '.bat' on the end.
You must also save as type: 'All Files'.



Now right click on your .bat file and select "Edit".



On the first line type:
    java -jar iri-*version_number*.jar -p 14265 -n "udp://neighborIP:14265 udp://NeighborIP2:14265"

On the second line type:
     pause

If you use dyndns services, you can add an -e to resolve connection problems after IP changes:
    java -jar iri-*version_number*.jar -p 14265 -n "udp://neighborIP:14265 udp://NeighborIP2:14265"



Save the changes.

You can now launch IOTA at any time by clicking this .BAT file.

Important things to note:
  • When exchanging nodes, your neighbour must also add your IP!
  • Your IRI file may have a version number after it and that would need to be typed too.
  • To add multiple neighbours, simply add them one after another with a space between, using the format above.


How to run a Headless Node on OSX

IMPORTANT: You need a static IP and also IP addresses from your future neighbours.

Step 1:

Download the newest IRI, available here: https://github.com/iotaledger/iri/releases/tag/v1.2.0
Save this file in a new folder on your desktop. Name the folder "IOTA headless".

Step 2:

Open the terminal, write the following and press enter: cd /Users/*Your-Mac-Username*/Desktop/IOTA\ headless
Now you can start to run IOTA in your terminal by entering the following:
  java -jar IRI-*version_number*.jar -p 14265 -n 'udp://neighborIP:14265 udp://NeighborIP_2:14265'

Step 3:

Download the latest Nostalgia version from GitHub: https://github.com/domschiener/nostalgia and run the nostalgia.html file with your browser. After entering your Seed you can generate addresses and broadcast transactions using Nostalgia. If Nostalgia is not working properly, try the following Step!

Troubleshooting:

If Nostalgia isn’t working properly (e.g generating an address doesn’t work), the issue might be that you do not have the latest version of Java installed or that your system is simply not using the latest version.

Check which version of java you are using by opening the terminal and running the following command: "java -version". The output should be something like:

java version "1.8.0_111"
Java(TM) SE Runtime Environment (build 1.8.0_111-b14)
Java HotSpot(TM) 64-Bit Server VM (build 25.111-b14, mixed mode)

Nostalgia needs version _66 or higher to run properly. If your Mac has the newest java version installed but it doesn’t show up when running the "java -version" command, follow this guide to resolve the issue: https://oliverdowling.com.au/2015/10/09/oracles-jdk-8-on-mac-os-x-el-capitan/


How to run a Headless Node on Linux

First, download the IRI-*version_number*.jar file to your computer.

The latest (experimental) version is: https://github.com/iotaledger/iri/releases/tag/v1.2.0

How to compile the IRI on UBUNTU:

1. Run sudo apt-get update and sudo apt-get install git

2. sudo apt-get install maven

3. If you want dev branch IRI (currently 1.1.2.6): git clone https://github.com/iotaledger/iri.git -b dev

4. type "cd iri" and then "mvn package"

5. Do "cd target/" and then "ls" to check if IRI was created successfully

To run in Linux:
java -jar IRI-*version_number*.jar -p 14265 -n “udp://NODEIP-1-HERE:14265 udp://NODEIP-2-HERE:14265”

Important things to note:
  • When exchanging nodes, your neighbour must also add your IP!
  • Your IRI file may have a version number after it and that would need to be typed too.
  • To add multiple neighbours, simply add them one after another with a space between, using the format above.

GUI (full node)

Setup difficulty: Intermediate

Headless Node (full node)

Setup difficulty: Hard

Lightwallet

Setup difficulty: Easy

Android Wallet

Mobile wallet | Setup difficulty: Easy