rsksmart/rskj repository overview

⁠Using this image

The easiest way to get started is running

docker run -p 5050:5050 rsksmart/rskj:IRIS-3.3.0

This will start a MainNet node. If you want to run a instead a TestNet node,

docker run -p 50505:50505 rsksmart/rskj:IRIS-3.3.0 --testnet

or even a RegTest node, for doing regression tests against it

docker run rsksmart/rskj:IRIS-3.3.0 --regtest

Keep in mind that RSK's blockchain is stored locally in the container. If you want to save it to a permanent storage, you can use a volume mount while starting the container:

docker run -p 5050:5050 -v /path/to/my/storage:/var/lib/rsk/.rsk rsksmart/rskj:IRIS-3.3.0

In order to interact with the node's JSON-RPC endpoint, you'll need to expose it to the host:

docker run -p 5050:5050 -p 127.0.0.1:4444:4444 rsksmart/rskj:IRIS-3.3.0

Then, you could, for example, query the current block number with

curl -H "Content-type: application/json" -d '{"jsonrpc":"2.0","method":"eth_blockNumber","id":1}' http://127.0.0.1:4444/

Finally, you can provide a custom configuration to the node with

docker run -p 5050:5050 -v /path/to/my/custom/node.conf:/etc/rsk/node.conf rsksmart/rskj:IRIS-3.3.0