- The Command Line
- Basic CLI Features
- Command: state
- Command: state pull
Command: state pull
The tofu state pull
command is used to manually download and output
the state from remote state. This command also
works with local state.
Usage
Usage: tofu state pull
This command downloads the state from its current location, upgrades the local copy to the latest state file version that is compatible with locally-installed OpenTofu, and outputs the raw format to stdout.
This is useful for reading values out of state (potentially pairing this command with something like jq). It is also useful if you need to make manual modifications to state.
You cannot use this command to inspect the OpenTofu version of the remote state, as it will always be converted to the current OpenTofu version before output.
OpenTofu state files must be in UTF-8 format without a byte order mark (BOM). For PowerShell on Windows, use Set-Content
to automatically encode files in UTF-8 format. For example, run tofu state pull | sc terraform.tfstate
.