You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

110 lines
2.7 KiB

7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
  1. Install Tendermint
  2. ==================
  3. From Binary
  4. -----------
  5. To download pre-built binaries, see the `Download page <https://tendermint.com/download>`__.
  6. From Source
  7. -----------
  8. You'll need ``go``, maybe ``glide``, and the Tendermint source code.
  9. Install Go
  10. ^^^^^^^^^^
  11. Make sure you have `installed Go <https://golang.org/doc/install>`__ and
  12. set the ``GOPATH``. You should also put ``GOPATH/bin`` on your ``PATH``.
  13. Get Source Code
  14. ^^^^^^^^^^^^^^^
  15. You should be able to install the latest with a simple
  16. ::
  17. go get github.com/tendermint/tendermint/cmd/tendermint
  18. Run ``tendermint --help`` and ``tendermint version`` to ensure your
  19. installation worked.
  20. If the installation failed, a dependency may have been updated and become
  21. incompatible with the latest Tendermint master branch. We solve this
  22. using the ``glide`` tool for dependency management.
  23. First, install ``glide``:
  24. ::
  25. go get github.com/Masterminds/glide
  26. Now we can fetch the correct versions of each dependency by running:
  27. ::
  28. cd $GOPATH/src/github.com/tendermint/tendermint
  29. glide install
  30. go install ./cmd/tendermint
  31. Note that even though ``go get`` originally failed, the repository was
  32. still cloned to the correct location in the ``$GOPATH``.
  33. The latest Tendermint Core version is now installed.
  34. Reinstall
  35. ---------
  36. If you already have Tendermint installed, and you make updates, simply
  37. ::
  38. cd $GOPATH/src/github.com/tendermint/tendermint
  39. go install ./cmd/tendermint
  40. To upgrade, there are a few options:
  41. - set a new ``$GOPATH`` and run
  42. ``go get github.com/tendermint/tendermint/cmd/tendermint``. This
  43. makes a fresh copy of everything for the new version.
  44. - run ``go get -u github.com/tendermint/tendermint/cmd/tendermint``,
  45. where the ``-u`` fetches the latest updates for the repository and
  46. its dependencies
  47. - fetch and checkout the latest master branch in
  48. ``$GOPATH/src/github.com/tendermint/tendermint``, and then run
  49. ``glide install && go install ./cmd/tendermint`` as above.
  50. Note the first two options should usually work, but may fail. If they
  51. do, use ``glide``, as above:
  52. ::
  53. cd $GOPATH/src/github.com/tendermint/tendermint
  54. glide install
  55. go install ./cmd/tendermint
  56. Since the third option just uses ``glide`` right away, it should always
  57. work.
  58. Troubleshooting
  59. ---------------
  60. If ``go get`` failing bothers you, fetch the code using ``git``:
  61. ::
  62. mkdir -p $GOPATH/src/github.com/tendermint
  63. git clone https://github.com/tendermint/tendermint $GOPATH/src/github.com/tendermint/tendermint
  64. cd $GOPATH/src/github.com/tendermint/tendermint
  65. glide install
  66. go install ./cmd/tendermint
  67. Run
  68. ^^^
  69. To start a one-node blockchain with a simple in-process application:
  70. ::
  71. tendermint init
  72. tendermint node --proxy_app=dummy