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.

111 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
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
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/downloads>`__.
  6. From Source
  7. -----------
  8. You'll need ``go``, maybe `dep <https://github.com/golang/dep>`__, 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 ``dep`` tool for dependency management.
  23. First, install ``dep``:
  24. ::
  25. cd $GOPATH/src/github.com/tendermint/tendermint
  26. make get_tools
  27. Now we can fetch the correct versions of each dependency by running:
  28. ::
  29. make get_vendor_deps
  30. make install
  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. make install
  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. ``make get_vendor_deps && make install`` as above.
  50. Note the first two options should usually work, but may fail. If they
  51. do, use ``dep``, as above:
  52. ::
  53. cd $GOPATH/src/github.com/tendermint/tendermint
  54. make get_vendor_deps
  55. make install
  56. Since the third option just uses ``dep`` 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. make get_tools
  66. make get_vendor_deps
  67. make install
  68. Run
  69. ^^^
  70. To start a one-node blockchain with a simple in-process application:
  71. ::
  72. tendermint init
  73. tendermint node --proxy_app=kvstore