Docker Integration

Usage
Blockscout requires PostgreSQL server. This is provided by starting the script (new docker image will be created named postgres)
Start command make start - Sets everything up and starts BlockScout in a docker container. To connect it to your local environment, configure using the ENV variables described below.
Example connecting to local ganache instance running on port 2000 on Mac/Windows:
COIN=DAI \
ETHEREUM_JSONRPC_VARIANT=ganache \ 
ETHEREUM_JSONRPC_HTTP_URL=http://host.docker.internal:2000 \
ETHEREUM_JSONRPC_WS_URL=ws://host.docker.internal:2000 \
make start
Blockscout will be available on localhost:4000
mac/Windows: Docker provides a special URL - host.docker.internal - that is available in the container and routed to your local machine.
Linux: Docker is starting using --network=host and all services are available on localhost
Migrations
By default, Makefile completes migrations on PostgreSQL creation.
You can also run migrations manually using the make migrate command.
Migrations will clean up your local database
Env variables
BlockScout supports 3 different JSON RPC Variants. Variant can be configured using ETHEREUM_JSONRPC_VARIANT environment variable.
Example:
ETHEREUM_JSONRPC_VARIANT=ganache \
make start
Do not use sudo with make start command since
Basically, whenever one uses sudo with the Makefile/Docker, it causes this error of not being able to communicate with the node.
​https://github.com/poanetwork/blockscout/issues/2795#issuecomment-546076853​
otherwise, application inside the container cannot read environment variables including archive node's RPC/WebSockets endpoints
Available options are:
nethermind - Nethermind JSON RPC (Default)
erigon - Erigon JSON RPC
geth - Geth JSON RPC
besu - Hyperledger Besu RPC
ganache - Ganache JSON RPC
Variable
Description
Default value
ETHEREUM_JSONRPC_VARIANT
Variant of your JSON RPC service: nethermind, erigon, geth, besu or ganache
nethermind
ETHEREUM_JSONRPC_HTTP_URL
HTTP JSON RPC URL Only for geth or ganache variant
See below - based on JSONRPC variant
ETHEREUM_JSONRPC_WS_URL
WS JSON RPC url
See below - based on JSONRPC variant
ETHEREUM_JSONRPC_TRACE_URL
Trace URL Only for nethermind, erigon, besu variants
http://localhost:8545
COIN
Default Coin
POA
LOGO
Coin logo
Empty
NETWORK
Network
Empty
SUBNETWORK
Subnetwork
Empty
NETWORK_ICON
Network icon
Empty
NETWORK_PATH
Network path
/
Default Values for JSONRPC Variants
ETHEREUM_JSONRPC_HTTP_URL default values:
For erigon, geth, nethermind, besu - http://localhost:8545
For ganache - http://localhost:7545
ETHEREUM_JSONRPC_TRACE_URL default values:
For erigon, nethermind, besu - http://localhost:8545
For ganache - http://localhost:7545
Known issues
Windows Makefile error
C:\Program Files\Docker\Docker\resources\bin\docker.exe: Error response from daemon: OCI runtime create failed: container_linux.go:349: starting container process caused "exec: "C:/Program Files/Git/usr/bin/sh": stat C:/Program Files/Git/usr/bin/sh: no such file or directory": unknown. make: * [Makefile:265: start] Error 127
On receiving this error you can change the Makefile and make the following adjustments to docker\Makefile:
From: $(DOCKER_IMAGE) /bin/sh -c "echo $MIX_ENV && mix do ecto.create, ecto.migrate"
To: $(DOCKER_IMAGE) //bin/sh -c "echo $MIX_ENV && mix do ecto.create, ecto.migrate"
From: $(DOCKER_IMAGE) /bin/sh -c "mix phx.server"
To: $(DOCKER_IMAGE) //bin/sh -c "mix phx.server"

Smart Contract Verification

Next - For Developers

Ansible Deployment (AWS Cloud)

Last modified 12d ago

Export as PDF

Copy link

On this page

Usage

Env variables

Default Values for JSONRPC Variants

Known issues

Windows Makefile error