Guide to headless IRI on Linux
  1. 1. Install Java on your distribution.
  2. 2. Make a folder to stay organized:
  3. mkdir iota #create a folder
  4. 3. Use the latest IRI from Github IRI Releases
  5. 4. Move iri-1.2.4.jar inside the iota folder. (latest version may have different numbering)
  6. 5. Inside the iota folder, create a new file called iota.ini (any text-editor is fine):
  7. nano iota.ini
  8. 6. Inside this iota.ini you can start with the following configuration:
  9. [IRI]
    PORT = 14265 
    UDP_RECEIVER_PORT = 14600
    NEIGHBORS = udp://neighbor1:14600 udp://neighbor2:14500 udp://neighbor3:14265
    IXI_DIR = ixi
    HEADLESS = true
    DEBUG = true
    TESTNET = false
    DB_PATH = db
    				
  10. iota.ini is automatically picked up as default by iri
  11. * PORT is the port which your IRI will be running on*
  12. * UDP_RECEIVER_PORT is the port which your neighbors will connect to you with*
  13. * NEIGHBORS is your mutual neighbor connections: Ideally 7-9 different neighbors
  14. * IXI_DIR is the directory for IXI extensions*
  15. * HEADLESS is true*
  16. * DEBUG is true to output running information*
  17. * TESTNET is false if you are running on mainnet*
  18. * DB_PATH is the directory for the database*
  19. 7. Find optimally 7-9 mutual neighbors in the #nodesharing channel on slack
  20. * Join slack from here: IOTA Slack *
  21. * New neighbors can be appended to the NEIGHBORS section with spaces *
  22. * You would give a potential neighbor: udp://your_node_ip:14600 (UDP set in the config above) *
  23. * When you add a new neighbor, you will need to restart IRI *
  24. * If using screen, enter it with screen -r and shut IRI down with Control+C *
  25. * Once shutdown, and with a new neighbor added to the iota.ini you can re-launch IRI *
  26. 8. Running IRI (Various options below):
  27. java -jar iri-1.2.4.jar
  28. * Simple launch, and uses iota.ini *
  29. java -jar iri-1.2.4.jar --remote --remote-limit-api 'addNeighbors, removeNeighbors, getNeighbors'
  30. * Launch, and allows remote light clients to connect to your node*
  31. screen -L -mS myIRI java -jar iri-1.2.4.jar
  32. * Launch using a screen. You can also add the remote flags as well. -L will log the console output of the screen for you.