Skip to content

Latest commit

 

History

History
executable file
·
99 lines (70 loc) · 2.9 KB

README.md

File metadata and controls

executable file
·
99 lines (70 loc) · 2.9 KB
Raw

Run in docker

Simple and fast setup of BetterChain on Docker is also available.

Install Dependencies

  • Docker Docker 17.05 or higher is required

Docker Requirement

  • At least 8GB RAM (Docker -> Preferences -> Advanced -> Memory -> 8GB or above)

Build betterchain image

git clone https://github.com/betterchainio/betterchain.git --recursive
cd betterchain/Docker
docker build . -t betterchain/betterchain

Start betterchaind docker container only

docker run --name betterchaind -p 8888:8888 -p 9876:9876 -t betterchain/betterchain start_betterchaind.sh arg1 arg2

By default, all data is persisted in a docker volume. It can be deleted if the data is outdated or corrupted:

$ docker inspect --format '{{ range .Mounts }}{{ .Name }} {{ end }}' betterchaind
fdc265730a4f697346fa8b078c176e315b959e79365fc9cbd11f090ea0cb5cbc
$ docker volume rm fdc265730a4f697346fa8b078c176e315b959e79365fc9cbd11f090ea0cb5cbc

Alternately, you can directly mount host directory into the container

docker run --name betterchaind -v /path-to-data-dir:/opt/betterchain/bin/data-dir -p 8888:8888 -p 9876:9876 -t betterchain/betterchain start_betterchaind.sh arg1 arg2

Get chain info

curl http://127.0.0.1:8888/v1/chain/get_info

Start both betterchaind and walletd containers

docker-compose up

After docker-compose up, two services named betterchaind and walletd will be started. betterchaind service would expose ports 8888 and 9876 to the host. walletd service does not expose any port to the host, it is only accessible to betterchainc when runing betterchainc is running inside the walletd container as described in "Execute betterchainc commands" section.

Execute betterchainc commands

You can run the betterchainc commands via a bash alias.

alias betterchainc='docker-compose exec walletd /opt/betterchain/bin/betterchainc -H betterchaind'
betterchainc get info
betterchainc get account inita

Upload sample exchange contract

betterchainc set contract exchange contracts/exchange/exchange.wast contracts/exchange/exchange.abi

If you don't need walletd afterwards, you can stop the walletd service using

docker-compose stop walletd

Change default configuration

You can use docker compose override file to change the default configurations. For example, create an alternate config file config2.ini and a docker-compose.override.yml with the following content.

version: "2"

services:
  betterchaind:
    volumes:
      - betterchaind-data-volume:/opt/betterchain/bin/data-dir
      - ./config2.ini:/opt/betterchain/bin/data-dir/config.ini

Then restart your docker containers as follows:

docker-compose down
docker-compose up

Clear data-dir

The data volume created by docker-compose can be deleted as follows:

docker volume rm docker_betterchaind-data-volume