2.2 KiB
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 theDATABASE_URLenvironment 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.