From d76e2dc3ff0d27d851a8658decfff40999878f04 Mon Sep 17 00:00:00 2001 From: Ethan Buchman Date: Sat, 19 May 2018 23:26:02 -0400 Subject: [PATCH] readme.rst -> readme.md --- networks/local/{README.rst => README.md} | 32 +++++++++--------------- 1 file changed, 12 insertions(+), 20 deletions(-) rename networks/local/{README.rst => README.md} (85%) diff --git a/networks/local/README.rst b/networks/local/README.md similarity index 85% rename from networks/local/README.rst rename to networks/local/README.md index 601d238d..af3b6c87 100644 --- a/networks/local/README.rst +++ b/networks/local/README.md @@ -1,14 +1,11 @@ -localnode -========= +# Local Docker Testnet -Requirements ------------- +## Requirements -- `Install docker `__. -- `Install docker-compose `__. +- [Install docker](https://docs.docker.com/engine/installation/) +- [Install docker-compose](https://docs.docker.com/compose/install/) -Build ------ +## Build Build the `tendermint` binary and the `tendermint/localnode` docker image: @@ -24,18 +21,15 @@ make build-linux # Build tendermint/localnode image make build-docker-localnode - ``` -Run a testnet -------------- +## Run a testnet To start a 4 node testnet run: ``` make localnet-start - -`` +``` The nodes bind their RPC servers to ports 46657, 46660, 46662, and 46664 on the host. This file creates a 4-node network using the localnode image. @@ -47,11 +41,9 @@ To update the binary, just rebuild it and restart the nodes: make build-linux make localnet-stop make localnet-start - ``` -Configuration ------------ +## Configuration The `make localnet-start` creates files for a 4-node testnet in `./build` by calling the `tendermint testnet` command. @@ -76,11 +68,11 @@ docker run -v `pwd`/build:/tendermint tendermint/localnode ``` -Logging -------- +## Logging + Log is saved under the attached volume, in the `tendermint.log` file. If the `LOG` environment variable is set to `stdout` at start, the log is not saved, but printed on the screen. -Special binaries ----------------- +## Special binaries + If you have multiple binaries with different names, you can specify which one to run with the BINARY environment variable. The path of the binary is relative to the attached volume.