Configuring IRI

There are two ways to configure the IRI node software. You can use commandline arguements or via an .INI file.

Running without a .INI file

java -jar iri.jar -p 14600
In order for IRI to be functional, you will need to find neighbors (see next section).
As such, you can connect to your neighbors with either protocol. In order to get the most out of IRI, we have also made a set of flags available for you.
OptionDescriptionExample
-cConfig INI file that can be used instead of CLI options. See more below-c iri.ini
-pThis is a mandatory option that defines the port to be used to send API commands to your node.-p 14800
-nNeighbors that you are connected with will be added via this option.-n "udp://148.148.148.148:14265 tcp://[2001:db8:a0b:12f0::1]:14265"
-uUDP receiver port. Standard port is 14600-u 14800
-tTCP receiver port. Standard port is 15600-t 14800
--testnetMakes it possible to run IRI with the IOTA testnet--testnet
--remoteRemotely access your node and send API commands--remote
--remote-authRequire authentication password for accessing remotely. Requires a correct username:hashedpassword combination--remote-auth iotatoken:LL9EZFNCHZCMLJLVUBCKJ
--remote-limit-apiExclude certain API calls from being able to be accessed remotely--remote-limit-api "attachToTangle, addNeighbors"
--send-limitLimit the outbound bandwidth consumption. Limit is set to mbit/s--send-limit 1.0
--max-peersLimit the number of max accepted peers. Default is set to 0 (mutual tethering) --max-peers 8
--dns-resolution-falseIgnores DNS resolution refreshing--dns-resolution-false

Configuring using an .INI File

You can also provide an ini file to store all of your command line options and easily update (especially neighbors) if needed. You can enable it via the --config flag.
Here is an example INI file:
[IRI] PORT = 14700
UDP_RECEIVER_PORT = 14700
NEIGHBORS = udp://my.favorite.com:15600 udp://148.148.148.148:14265 tcp://[2001:db8:a0b:12f0::1]:14265
IXI_DIR = ixi
HEADLESS = true
DEBUG = true
TESTNET = true
DB_PATH = db

To run IRI with this .INI file, given its named `iri.ini`, use this command:
java -jar iri.jar -c iri.ini