Running Trustlines via docker-compose

This directory contains the files needed to start a trustlines system via docker-compose. Following these setup instructions will give you a system, where you can:

  • connect to a trustlines laika node via JSONRPC on port 8545
  • use the trustlines laika node as a metamask backend
  • connect to a relay server on port 5000 and interact with currency networks running on chain

Please be aware that you additionally might have to firewall the installed system if you don’t want to expose those services.


The docker-compose file contains service definitions for the following services:

  • db: A service running a postgres server. The postgres files will be stored in the postgres-data docker volume.

  • tlbc: A service running a modified parity node for the trustlines blockchain. The blockchain data will be stored in the blockchain-data docker volume.

  • index: A service running py-eth-index, which synchronizes certain information from parity into the postgres database.

  • relay: The relay server itself.


We need to do some initial setup and configuration for the system to work. You need to provide the addresses.json file, which should be put in the directory alongside the docker-compose.yml file.

This directory contains working example files for contracts already deployed on the laika blockchain. If you deploy your own contracts, please adapt addresses.json accordingly.

Fetch docker image

Let’s first build and fetch all of the images that we will need without starting any services with the following command:

docker-compose up --no-start

Generate keys

The relay server either needs a parity node with an unlocked account or it needs a key to sign transactions itself. We will use the latter method.

Please generate a keystore file by running the following command. It will ask for a password.

docker run --rm -it -v $(pwd):/here --entrypoint /opt/relay/bin/deploy-tools trustlines/relay generate-keystore --keystore-path /here/keystore.json

We also need to store the password in clear text. Please create a file ‘keystore-password.txt’ containing only the password on the first line.

Of course you can also use an existing keyfile, but please do not reuse a keyfile from a validator node.

Copy compiled contracts

The relay server image containts the file ‘contracts.json’, which contains the compiled currency network contracts. We will need this file for the index service.

Please copy them to the current directory with:

docker-compose run --rm --no-deps -v $(pwd):/here --entrypoint /bin/bash relay -c "cp /opt/relay/trustlines-contracts/build/contracts.json /here"

Setup initial database

We need to setup the database and import the ABIs for the index service by running the following commands:

docker-compose up -d db
sleep 2
docker-compose run --rm index createtables
docker-compose run --rm index importabi

After that you can start the system with docker-compose up -d, though you have to wait for the blockchain node to sync with the trustlines blockchain in order to have a fully functioning system.

The account you’ve setup at the beginning will have to pay for transactions. Please fund it with enough coins. You should now be able to connect to the local node via metamask to do that.

Test the installation

Please try to run the following command:

curl http://localhost:5000/api/v1/networks

It should print some information about the networks as JSON.

Next Steps

The relay server provides a REST API. Please read relay server API documentation for more information.

You can also use the clientlib to access the relay server from javascript. Please visit the clientlib github repository for more information.