Validated: 2020/02/19

Building and Running the Cardano DB Sync Node

The cardano-db-sync node is built and tested to run on Linux. It may run on Mac OS X or Windows but that is unsupported.

Running the db sync node will require Nix and either multiple terminals or a multi terminal emulator like GNU Screen or TMux. Setup IOHK binary cache to avoid several hours of build time.

The db sync node is designed to work with a locally running Cardano Node. The two git repositories need to be checked out so that they are both at the same level. eg:

> tree -L 1
├── cardano-db-sync
├── cardano-node

To setup and run db sync node for testnet replace mainnet with testnet in all examples below. These instuction assume than only blocks and transactions for a single blockchain are inserted in the db. If you want to to use a single database for more than one chain, you will need to duplicate config/pgpass and provide a unique db name for each chain (ie mainnet uses cexplorer). An example testnet PGPASSFILE is at config/pgpass-testnet.

Set up and run a local node

git clone
cd cardano-node
nix-build -A scripts.mainnet.node -o mainnet-node-local

Set up and run the db-sync node

git clone
cd cardano-db-sync
nix-build -A cardano-db-sync -o db-sync-node
scripts/ --createdb
PGPASSFILE=config/pgpass db-sync-node/bin/cardano-db-sync \
    --config config/mainnet-config.yaml \
    --socket-path ../cardano-node/state-node-mainnet/node.socket \
    --schema-dir schema/

Run two chains with a single PostgreSQL instance

By running two cardano-nodes and using two databases within a singe PostgresSQL instance it is possible to sync two (or more chains).

The two nodes might be run in separate terminals using:

nix-build -A scripts.mainnet.node -o mainnet-node-remote && ./mainnet-node-remote


nix-build -A scripts.testnet.node -o testnet-node-remote && ./testnet-node-remote

and then the two db-sync process run as:

PGPASSFILE=config/pgpass ./cardano-db-sync-extended-exe \
    --config config/mainnet-config.yaml \
    --socket-path ../cardano-node/state-node-mainnet/node.socket --schema-dir schema/


PGPASSFILE=config/pgpass-testnet ./cardano-db-sync-extended-exe \
    --config config/testnet-config.yaml \
    --socket-path ../cardano-node/state-node-testnet/node.socket --schema-dir schema/