Running the Stratis Full Node

Pre-Requisites

Download and install .NET Core Runtime version 3.1 or newer:

https://dotnet.microsoft.com/download/dotnet-core

Download and unpack Stratis Full Node release:

https://github.com/stratisproject/StratisFullNode/releases

Default port configuration

Following table summarizes port configuration used by the Stratis node

Port Network Description
TCP/17105 Strax Mainnet P2P protocol
TCP/17104 Strax Mainnet RPC server
TCP/17103 Strax Mainnet API interface
TCP/27105 Strax Testnet P2P protocol
TCP/27104 Strax Testnet RPC server
TCP/27103 Strax Testnet API interface
TCP/37105 Strax Regtest P2P protocol
TCP/37104 Strax Regtest RPC server
TCP/37103 Strax Regtest API interface
TCP/16179 Cirrus Mainnet P2P protocol
TCP/16175 Cirrus Mainnet RPC server
TCP/37223 Cirrus Mainnet API interface
TCP/26179 Cirrus Testnet P2P protocol
TCP/26175 Cirrus Testnet RPC server
TCP/38223 Cirrus Testnet API interface
TCP/26179 Cirrus Regtest P2P protocol
TCP/26175 Cirrus Regtest RPC server
TCP/38223 Cirrus Regtest API interface

Configuring the Stratis Node

The Stratis Node can be configured through parameters passed to the executable or through configuration file.

Command-line only options

Option Default value Format Description
-datadir

%AppData%Roa mingStratisNode

~/.StratisNode

Filesystem path in OS specific format Location of the node’s data folder
-testnet 0

0 – Disabled

1 – Enabled

Start the node with Testnet network
-regtest 0

0 – Disabled

1 – Enabled

Start the node with Regtest network

Options which could be placed in stratis.conf configuration file or passed as parameters to the process

Option Default value Format Description
port 17105 1-65535 The default network port to connect to
bind 0.0.0.0:17105 ip:port Bind to given address. Use [host]:port notation for IPv6. Can be specified multiple times.
connect   ip:port

Specified node to connect to. Can be specified multiple times.

Using that option will disable ability to accept inbound connections

addnode   ip:port Add a node to connect to and attempt to keep the connection open. Can be specified multiple times.
maxoutbo undconnections 16 Numeric value The maximum number of outbound connections
maxinbo undconnections 109 Numeric value The maximum number of inbound connections
agentprefix   Text An optional prefix for the node’s user agent shared with peers. Truncated if over 10 characters.
txindex     Enable to maintain a full transaction index
apiuri http://lo calhost:27103/ URL URI to node’s API interface powered by Swagger
server 0

0 – Disabled

1 – Enabled

Activate RPC Server; pass 0 to disable or 1 to enable RPC server
rpcbind 127.0.0.1: 17104 ip:port Network address to which the RPC will bind to
rpcallowip 127.0.0.1/32 Network/subnet (I.e. 10.0.0.0/8) IP address allowed to connect to RPC

There are many parameters that can be utilised when launching the Stratis Full Node, some of these parameters will differ dependent upon how the Stratis Full Node will be utilised.

A comprehensive list of available options can be found in the stratis.conf which is in the defined data directory upon first-launch of the Stratis Full Node.

Running the Stratis Node

Windows Example

Stratis.StraxD.exe -datadir=C:\StratisNode

Linux Example

Stratis.StraxD -datadir=/home/stratis/StratisNode

After executing the above command, the Stratis Full Node will start and begin peer discovery to obtain a copy of the StratisTest blockchain.

After a short period of time several peers will be discovered, this will be evidenced from the console window.

../../_images/image2.png