History

nico 07a8bc3f2b init		2 years ago
..
envs	init	2 years ago
README.md	init	2 years ago
docker-compose-no-build-erigon.yml	init	2 years ago
docker-compose-no-build-ganache.yml	init	2 years ago
docker-compose-no-build-geth.yml	init	2 years ago
docker-compose-no-build-hardhat-network.yml	init	2 years ago
docker-compose-no-build-nethermind.yml	init	2 years ago
docker-compose-no-build-no-db-container.yml	init	2 years ago
docker-compose-no-rust-verification.yml	init	2 years ago
docker-compose.yml	init	2 years ago

README.md

Docker-compose configuration

Runs Blockscout locally in Docker containers with docker-compose.

Prerequisites

Docker v20.10+
Docker-compose 2.x.x+
Running Ethereum JSON RPC client

Building Docker containers from source

docker-compose up --build

This command uses by-default docker-compose.yml, which builds the explorer into the Docker image and runs 3 Docker containers:

Postgres 14.x database, which will be available at port 7432 on localhost.
Smart-contract-verifier service, which will be available at port 8043 on localhost.
Blockscout explorer at http://localhost:4000.

Note for Linux users: Linux users need to run the local node on http://0.0.0.0/ rather than http://127.0.0.1/

Building Docker containers from source with native smart contract verification (deprecated)

docker-compose -f docker-compose-no-rust-verification.yml up --build

Configs for different Ethereum clients

The repo contains built-in configs for different clients without needing to build the image.

Erigon: docker-compose -f docker-compose-no-build-erigon.yml up -d
Geth: docker-compose -f docker-compose-no-build-geth.yml up -d
Nethermind, OpenEthereum: docker-compose -f docker-compose-no-build-nethermind up -d
Ganache: docker-compose -f docker-compose-no-build-ganache.yml up -d
HardHat network: docker-compose -f docker-compose-no-build-hardhat-network.yml up -d
Running explorer only without DB: docker-compose -f docker-compose-no-build-no-db-container.yml up -d. In this case, one container is created - for the explorer itself. It assumes DB credentials are provided through the DATABASE_URL environment variable.

All of the configs assume the Ethereum JSON RPC is running at http://localhost:8545.

In order to stop launched containers, run docker-compose -d -f config_file.yml down, replacing config_file.yml with the file name of the config which was previously launched.

You can adjust BlockScout environment variables from ./envs/common-blockscout.env. Descriptions of the ENVs are available in the docs.