Skip to content

Files

Latest commit

Oct 28, 2022
f927cc5 · Oct 28, 2022

History

History
This branch is 27 commits ahead of, 3964 commits behind blockscout/blockscout:master.

docker-compose

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
Oct 28, 2022
Sep 16, 2022
Sep 30, 2022
Sep 30, 2022
Sep 30, 2022
Sep 30, 2022
Sep 30, 2022
Sep 30, 2022
Sep 30, 2022
Sep 30, 2022

Docker-compose configuration

Runs BlockScout locally in Docker container with usage 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 build the explorer into Docker image and runs 3 Docker containers:

  • one for the database. Postgres 13.x, which will be available at port 7432 on localhost
  • smart-contract-verifier service, which will be available at port 8043 on localhost
  • and the BlockScout explorer at http://localhost:4000

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

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

Configs for different Ethereum clients

Also, the repo contains built-in configs for different clients without need 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 only explorer 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. And it assumes that the DB credentials are provided through DATABASE_URL environment variable.

All of the configs assume, that 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, where replace config_file.yml with the file name of the config, which has been launched before.

You can play with the BlockScout environment variables, which are present at ./envs/common-blockscout.env. The description of the environment variables are available in the docs.