Installation

terraform-docs is available on Linux, macOS, Windows, and FreeBSD platforms.

Homebrew

If you are a macOS user, you can use Homebrew.

brew install terraform-docs

or

brew install terraform-docs/tap/terraform-docs

Windows

If you are a Windows user:

Scoop

You can use Scoop.

scoop bucket add terraform-docs https://github.com/terraform-docs/scoop-bucket
scoop install terraform-docs

Chocolatey

or you can use Chocolatey.

choco install terraform-docs

Docker

You also can run terraform-docs as a container:

docker run quay.io/terraform-docs/terraform-docs:0.15.0

Pre-compiled Binary

Stable binaries are available on the GitHub Release page. To install, download the file for your platform from “Assets” and place it into your $PATH:

curl -sSLo ./terraform-docs.tar.gz https://terraform-docs.io/dl/v0.15.0/terraform-docs-v0.15.0-$(uname)-amd64.tar.gz
tar -xzf terraform-docs.tar.gz
chmod +x terraform-docs
mv terraform-docs /some-dir-in-your-PATH/terraform-docs

Go Users

The latest version can be installed using go get:

GO111MODULE="on" go get github.com/terraform-docs/terraform-docs@v0.15.0
# only for v0.9.1 and before
GO111MODULE="on" go get github.com/segmentio/terraform-docs@v0.9.1

This will put terraform-docs in $(go env GOPATH)/bin. If you encounter the error terraform-docs: command not found after installation then you may need to either add that directory to your $PATH as shown [here] or do a manual installation by cloning the repo and run make build from the repository which will put terraform-docs in:

$(go env GOPATH)/src/github.com/terraform-docs/terraform-docs/bin/$(uname | tr '[:upper:]' '[:lower:]')-amd64/terraform-docs

Code Completion

The code completion for bash or zsh can be installed as follow. Note that shell auto-completion is not available on Windows platform.

bash

terraform-docs completion bash > ~/.terraform-docs-completion
source ~/.terraform-docs-completion

# or the one-liner below

source <(terraform-docs completion bash)

zsh

terraform-docs completion zsh > /usr/local/share/zsh/site-functions/_terraform-docs
autoload -U compinit && compinit

To make this change permanent, the above commands can be added to ~/.profile file.

Edit on GitHub