github.com/hobbeswalsh/terraform@v0.3.7-0.20150619183303-ad17cf55a0fa/website/source/intro/getting-started/install.html.markdown (about)

     1  ---
     2  layout: "intro"
     3  page_title: "Installing Terraform"
     4  sidebar_current: "gettingstarted-install"
     5  description: |-
     6    Terraform must first be installed on your machine. Terraform is distributed as a binary package for all supported platforms and architecture. This page will not cover how to compile Terraform from source.
     7  ---
     8  
     9  # Install Terraform
    10  
    11  Terraform must first be installed on your machine. Terraform is distributed
    12  as a [binary package](/downloads.html) for all supported platforms and
    13  architecture. This page will not cover how to compile Terraform from
    14  source.
    15  
    16  ## Installing Terraform
    17  
    18  To install Terraform, find the [appropriate package](/downloads.html) for
    19  your system and download it. Terraform is packaged as a zip archive.
    20  
    21  After downloading Terraform, unzip the package into a directory where
    22  Terraform will be installed. The directory will contain a set of binary
    23  programs, such as `terraform`, `terraform-provider-aws`, etc. The final
    24  step is to make sure the directory you installed Terraform to is on the
    25  PATH. See
    26  [this page](http://stackoverflow.com/questions/14637979/how-to-permanently-set-path-on-linux)
    27  for instructions on setting the PATH on Linux and Mac.
    28  [This page](http://stackoverflow.com/questions/1618280/where-can-i-set-path-to-make-exe-on-windows)
    29  contains instructions for setting the PATH on Windows.
    30  
    31  ## Verifying the Installation
    32  
    33  After installing Terraform, verify the installation worked by opening a new
    34  terminal session and checking that `terraform` is available. By executing
    35  `terraform` you should see help output similar to that below:
    36  
    37  ```
    38  $ terraform
    39  usage: terraform [--version] [--help] <command> [<args>]
    40  
    41  Available commands are:
    42      apply      Builds or changes infrastructure
    43      destroy    Destroy Terraform-managed infrastructure
    44      get        Download and install modules for the configuration
    45      graph      Create a visual graph of Terraform resources
    46      init       Initializes Terraform configuration from a module
    47      output     Read an output from a state file
    48      plan       Generate and show an execution plan
    49      refresh    Update local state file against real resources
    50      remote     Configure remote state storage
    51      show       Inspect Terraform state or plan
    52      taint      Manually mark a resource for recreation
    53      version    Prints the Terraform version
    54  ```
    55  
    56  If you get an error that `terraform` could not be found, then your PATH
    57  environment variable was not setup properly. Please go back and ensure
    58  that your PATH variable contains the directory where Terraform was installed.
    59  
    60  Otherwise, Terraform is installed and ready to go! Nice!
    61  
    62  ## Next Step
    63  
    64  Time to [build infrastructure](/intro/getting-started/build.html)
    65  using a minimal Terraform configuration file. You will be able to
    66  examine Terraform's execution plan before you deploy it to AWS.