terraform/website/docs/cli/commands/state/pull.mdx

---
page_title: 'Command: state pull'
description: >-
  The `terraform state pull` command is used to manually download and output the
  state from remote state.
---

# Command: state pull

The `terraform state pull` command is used to manually download and output
the state from [remote state](/language/state/remote). This command also
works with local state.

## Usage

Usage: `terraform state pull`

This command will download the state from its current location, upgrade the
local copy to the latest state file version that is compatible with
locally-installed Terraform, and output the raw format to stdout.

This is useful for reading values out of state (potentially pairing this
command with something like [jq](https://stedolan.github.io/jq/)). It is
also useful if you need to make manual modifications to state.

~> Note: This command cannot be used to inspect the Terraform version of
the remote state, as it will always be converted to the current Terraform
version before output.