| layout | docs |
|---|---|
| page_title | Command: remote push |
| sidebar_current | docs-commands-remote-push |
| description | The `terraform remote push` command is used to push a cached local copy of the state to a remote storage server. |
The terraform remote push uploads the cached state file to the
remote server when remote state storage is enabled. The remote config
command should be used to enable
remote state storage.
Uploading is typically done automatically when running a Terraform command that modifies state, but this can be used to retry uploads if a transient failure occurs.
Usage: terraform remote push
The remote push command is invoked without options to upload the
local cached state to the remote storage server.