Running a Parity Ethereum node in Docker and connect safely

Peter Reitsma
May 3, 2016 · 4 min read
Image for post
Image for post

Parity is an Ethereum client written in Rust by the good people of Ethcore. It syncs up way faster than the Go client and somehow takes a lot less disk space. You can get it running in a Docker container, and connect to it, taking the following steps:

Step 1 — Download and play

docker pull ethcore/parity:beta-release

Check the Dockerfile of this image here if you like. To get an idea of all the options, you can run:

docker run -ti ethcore/parity:beta-release --help

Step 2 — Start it up

docker run -it --name=my-parity ethcore/parity:beta-release

You will see the parity node booting up and start syncing. If you have worked with the Ethereum Go client before, you will appreciate the speed. By default, parity will start syncing the Homestead chain. You can specify a different chain like Ropsten Testnet or Ethereum Classis using the chain flag:

docker run -it --name=my-parity ethcore/parity:beta-release \ 
--chain ropsten|classic

Leaving the docker session with CTRL-c will stop the attached container. Use CTRL-p CTRL-q to gracefully detach and keep parity syncing. You can reattach using:

docker attach my-parity

No problem if you accidentily stop it. You can just restart the docker container again by issuing:

docker start my-parity

If you want to restart your parity container with new settings, you should first remove the old

docker rm my-parity

Step 3— Store the blocks on host machine

docker run -ti \ 
-v /var/parity/testnet:/root/.parity \
--name my-parity \

In the above example we map the host directory /var/parity/testnet to the directory inside the Docker container where Parity stores the blocks /root/.parity .

To see if it is up-to-date, attach using docker attach, check the latest block number on etherchain and compare it to the block number in the parity output

[ #1449908 f3a0…6179 ] — -[ 0 blk/s | 0 tx/s | 0 gas/s //··· 0/17 peers, #1449908, 0+0 queued ···// mem: 28 MiB db, 127 KiB chain, 2 KiB queue, 24 KiB sync ]

Marvel at the moderate disk consumption of the Parity client.

Step 4— Expose it to the outside world

docker run -ti -d -p 8545:8545
--name my-parity ethcore/parity --jsonrpc-interface ''

The -p option of docker exposes the default JSON RPC port 8545 to the world outside docker.

For me, to get a connection from a remote host I needed to add the jsonrpc-interface flag and the jsonrpc-interface flag set to all:

docker run -ti -d -p --name my-parity ethcore/parity --jsonrpc-interface all --jsonrpc-hosts all

Step 5— Connect with Web3

npm install web3

From the node console, or using a node script you can run

Web3 = require(“web3”);
web3 = new Web3(new Web3.providers.HttpProvider(“http://[hostname]:8545"));

If the setup is correct, this will return the most recently mined block number and proof you are connected.

Now you are ready to start developing against the Ethereum node.

Step 6— restricting access

I am running on Ubuntu and first tried restricting access using UFW. It seems UFW and Docker are not the best friends, to say the least. (See here and here). So I did it with iptables directly blocking the forward to port 8545 on the parity container. Bash script below does it, first finding the IP of the parity container. Run sudo -i first.

parity_ip=$(docker inspect --format '{{ .NetworkSettings.IPAddress }}' my-parity)remote_ip=[your remote ip]iptables -I FORWARD 1 -d $parity_ip -p tcp --dport 8545 ! -s $remote_ip -j DROP

If you want to delete the iptables rule, first find it’s number on the FORWARD chain:

iptables -L FORWARD --line-numbers

and then drop it by number

iptables -D FORWARD 1 #or any other number

If this works for you (assert that access is blocked from another IP!) you can make the iptables settings persistent with

apt-get update
apt-get install iptables-persistent

If you have this package already installed, or to save any further iptables configuration, use

invoke-rc.d iptables-persistent save

Step 7— docker compose

image: ethcore/parity:1.1.0
container_name: my-parity
working_dir: /parity/
command: target/release/parity -j --jsonrpc-interface ‘’
- “8545:8545”

Get it up and running with

docker-compose up -d

I wrote another article on How to quickly upgrade an Ethereum Parity node using Docker.

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch

Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore

Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store