Skip to content

Run a reader node on your local machine

Creating the folders

First we need to create the conf and storage folders for the application:

sudo mkdir -p /opt/pbc-mainnet/conf
sudo mkdir -p /opt/pbc-mainnet/storage

Creating the node config.json

Start by opening the file in nano:

sudo nano /opt/pbc-mainnet/conf/config.json
You paste this into config.json:
  "restPort": 8080,
  "floodingPort": 9888,
  "knownPeers": [

To save the file press CTRL+O and then ENTER and then CTRL+X.

You can verify the contents of the files are what you expect by opening them with cat:

sudo cat /opt/pbc-mainnet/conf/config.json
# The config file should be printed here

Setting file permissions

Now we need to make sure the user with uid 1500 has the needed access to the files:

sudo chown -R "1500:1500" /opt/pbc-mainnet
sudo chmod 500 /opt/pbc-mainnet/conf
sudo chmod 700 /opt/pbc-mainnet/storage
sudo chmod 400 /opt/pbc-mainnet/conf/config.json

The above commands set conservative permissions on the folders the node is using. chmod 500 makes the config folder readable by the PBC node and root. chmod 700 makes the storage folder readable and writable for the PBC node and root.

Pull docker image

You can run the node using the docker-compose.

Start by creating a directory pbc and add a file named docker-compose.yml.

cd ~
mkdir -p pbc
We put the folder containing docker-compose.yml in home directory to prevent users who access docker from gaining easy access to information in the config.json. Therefor you can execute the following docker commands without superuser privileges.
cd pbc
nano docker-compose.yml

The contents of the file should be the following:

version: "2.0"
    container_name: pbc-mainnet
    user: "1500:1500"
    restart: always
    - "8080"
    - "9888-9897:9888-9897"
    command: [ "/conf/config.json", "/storage/" ]
    - /opt/pbc-mainnet/conf:/conf
    - /opt/pbc-mainnet/storage:/storage
Save the file by pressing CTRL+O and then ENTER and then CTRL+X. Keep an eye on the indentation since YAML is whitespace sensitive, and it won't work if the indentation is off.

You don't yet have access to the Partisia container repository, so you first need to log in.

docker login -u <GitLab e-mail address>

Note: If you have two-factor login enabled in GitLab you need to create a personal access token.

You can now start the node:

docker-compose up -d

This should pull the latest image and start the reader node in the background. If the command was executed successfully it won't print anything. To verify that the node is running, run:

docker logs -f pbc-mainnet

This should print a bunch of log statements. All the timestamps are in UTC and can therefore be offset several hours from your local time.