github.com/true-sqn/fabric@v2.1.1+incompatible/docs/source/prereqs.rst (about) 1 Prerequisites 2 ============= 3 4 Before you begin, you should confirm that you have installed all the prerequisites below on the platform where you will be running Hyperledger Fabric. 5 6 .. note:: These prerequisites are recommended for Fabric users. If you are a Fabric developer you should refer to the instructions for :doc:`dev-setup/devenv`. 7 8 Install Git 9 ----------- 10 Download the latest version of `git 11 <https://git-scm.com/downloads>`_ if it is not already installed, 12 or if you have problems running the curl commands. 13 14 Install cURL 15 ------------ 16 17 Download the latest version of the `cURL 18 <https://curl.haxx.se/download.html>`__ tool if it is not already 19 installed or if you get errors running the curl commands from the 20 documentation. 21 22 .. note:: If you're on Windows please see the specific note on `Windows 23 extras`_ below. 24 25 Docker and Docker Compose 26 ------------------------- 27 28 You will need the following installed on the platform on which you will be 29 operating, or developing on (or for), Hyperledger Fabric: 30 31 - MacOSX, \*nix, or Windows 10: `Docker <https://www.docker.com/get-docker>`__ 32 Docker version 17.06.2-ce or greater is required. 33 - Older versions of Windows: `Docker 34 Toolbox <https://docs.docker.com/toolbox/toolbox_install_windows/>`__ - 35 again, Docker version Docker 17.06.2-ce or greater is required. 36 37 You can check the version of Docker you have installed with the following 38 command from a terminal prompt: 39 40 .. code:: bash 41 42 docker --version 43 44 .. note:: The following applies to linux systems running systemd. 45 46 Make sure the docker daemon is running. 47 48 .. code:: bash 49 50 sudo systemctl start docker 51 52 Optional: If you want the docker daemon to start when the system starts, use the following: 53 54 .. code:: bash 55 56 sudo systemctl enable docker 57 58 Add your user to the docker group. 59 60 .. code:: bash 61 62 sudo usermod -a -G docker <username> 63 64 .. note:: Installing Docker for Mac or Windows, or Docker Toolbox will also 65 install Docker Compose. If you already had Docker installed, you 66 should check that you have Docker Compose version 1.14.0 or greater 67 installed. If not, we recommend that you install a more recent 68 version of Docker. 69 70 You can check the version of Docker Compose you have installed with the 71 following command from a terminal prompt: 72 73 .. code:: bash 74 75 docker-compose --version 76 77 .. _windows-extras: 78 79 Windows extras 80 -------------- 81 82 On Windows 10 you should use the native Docker distribution and you 83 may use the Windows PowerShell. However, for the ``binaries`` 84 command to succeed you will still need to have the ``uname`` command 85 available. You can get it as part of Git but beware that only the 86 64bit version is supported. 87 88 Before running any ``git clone`` commands, run the following commands: 89 90 :: 91 92 git config --global core.autocrlf false 93 git config --global core.longpaths true 94 95 You can check the setting of these parameters with the following commands: 96 97 :: 98 99 git config --get core.autocrlf 100 git config --get core.longpaths 101 102 These need to be ``false`` and ``true`` respectively. 103 104 The ``curl`` command that comes with Git and Docker Toolbox is old and 105 does not handle properly the redirect used in 106 :doc:`getting_started`. Make sure you have and use a newer version 107 which can be downloaded from the `cURL downloads page 108 <https://curl.haxx.se/download.html>`__ 109 110 .. note:: If you have questions not addressed by this documentation, or run into 111 issues with any of the tutorials, please visit the :doc:`questions` 112 page for some tips on where to find additional help. 113 114 .. Licensed under Creative Commons Attribution 4.0 International License 115 https://creativecommons.org/licenses/by/4.0/