github.com/umeshredd/helm@v3.0.0-alpha.1+incompatible/docs/install.md (about)

     1  # Installing Helm
     2  
     3  There are two parts to Helm: The Helm client (`helm`) and the Helm
     4  library. This guide shows how to install both together.
     5  
     6  
     7  ## Installing Helm
     8  
     9  Helm can be installed either from source, or from pre-built binary releases.
    10  
    11  ### From the Binary Releases
    12  
    13  Every [release](https://github.com/helm/releases) of Helm
    14  provides binary releases for a variety of OSes. These binary versions
    15  can be manually downloaded and installed.
    16  
    17  1. Download your [desired version](https://github.com/helm/releases)
    18  2. Unpack it (`tar -zxvf helm-v2.0.0-linux-amd64.tgz`)
    19  3. Find the `helm` binary in the unpacked directory, and move it to its
    20     desired destination (`mv linux-amd64/helm /usr/local/bin/helm`)
    21  
    22  From there, you should be able to run the client: `helm help`.
    23  
    24  ### From Homebrew (macOS)
    25  
    26  Members of the Kubernetes community have contributed a Helm formula build to
    27  Homebrew. This formula is generally up to date.
    28  
    29  ```
    30  brew install kubernetes-helm
    31  ```
    32  
    33  (Note: There is also a formula for emacs-helm, which is a different
    34  project.)
    35  
    36  ### From Chocolatey (Windows)
    37  
    38  Members of the Kubernetes community have contributed a [Helm package](https://chocolatey.org/packages/kubernetes-helm) build to
    39  [Chocolatey](https://chocolatey.org/). This package is generally up to date.
    40  
    41  ```
    42  choco install kubernetes-helm
    43  ```
    44  
    45  ## From Script
    46  
    47  Helm now has an installer script that will automatically grab the latest version
    48  of Helm and [install it locally](https://raw.githubusercontent.com/helm/helm/master/scripts/get).
    49  
    50  You can fetch that script, and then execute it locally. It's well documented so
    51  that you can read through it and understand what it is doing before you run it.
    52  
    53  ```
    54  $ curl https://raw.githubusercontent.com/helm/helm/master/scripts/get > get_helm.sh
    55  $ chmod 700 get_helm.sh
    56  $ ./get_helm.sh
    57  ```
    58  
    59  Yes, you can `curl https://raw.githubusercontent.com/helm/helm/master/scripts/get | bash` that if you want to live on the edge.
    60  
    61  ### From Canary Builds
    62  
    63  "Canary" builds are versions of the Helm software that are built from
    64  the latest master branch. They are not official releases, and may not be
    65  stable. However, they offer the opportunity to test the cutting edge
    66  features.
    67  
    68  Canary Helm binaries are stored at [get.helm.sh](https://get.helm.sh).
    69  Here are links to the common builds:
    70  
    71  - [Linux AMD64](https://get.helm.sh/helm-canary-linux-amd64.tar.gz)
    72  - [macOS AMD64](https://get.helm.sh/helm-canary-darwin-amd64.tar.gz)
    73  - [Experimental Windows AMD64](https://get.helm.sh/helm-canary-windows-amd64.zip)
    74  
    75  ### From Source (Linux, macOS)
    76  
    77  Building Helm from source is slightly more work, but is the best way to
    78  go if you want to test the latest (pre-release) Helm version.
    79  
    80  You must have a working Go environment with
    81  [dep](https://github.com/golang/dep) installed.
    82  
    83  ```console
    84  $ cd $GOPATH
    85  $ mkdir -p src/helm.sh
    86  $ cd src/helm.sh
    87  $ git clone https://github.com/helm/helm.git
    88  $ cd helm
    89  $ make
    90  ```
    91  
    92  If required, it will first install dependencies, rebuild the
    93  `vendor/` tree, and validate configuration. It will then compile `helm` and
    94  place it in `bin/helm`.
    95  
    96  ## Conclusion
    97  
    98  In most cases, installation is as simple as getting a pre-built `helm` binary
    99  and running `helm init`. This document covers additional cases for those
   100  who want to do more sophisticated things with Helm.
   101  
   102  Once you have the Helm Client successfully installed, you can
   103  move on to using Helm to manage charts.