Running Locally

The docker-compose file is meant for local dev environments (although it could just as easily be used in production environments as well with the right setup). In order to run the containers locally, you can follow the instructions below, which also includes some details on the necessary non-docker pre-setup.

Pre-requisites

1. Install base58 on your system:

   pip3 install base58

2. Install Docker Desktop on your machine (Windows, Mac) or install docker (Linux).

3. Generate the required keys:

   # build the datatool
   cargo build --bin strata-datatool
   cd docker
   ./init-keys.sh <path_to_strata_datatool> # typically, ../target/debug/strata-datatool

   The above step should create root xprivs in the docker/configs directory.

Running

Build and run the containers.

docker compose up --build

Chances are that the above step will fail as some bitcoin blocks have to be mined before the strata_client container can work properly. Mining of the required number of blocks should happen automatically when the stata_bitcoind container starts. After that, you can simply restart the containers:

docker start strata_sequencer
docker start strata_reth_fn # if you want to test the full node
# if you want to test the bridge clients
docker start bridge-client-1
docker start bridge-client-2