terraform/website/source/docs/commands/remote-push.html.markdown

layout	page_title	sidebar_current	description
docs	Command: remote push	docs-commands-remote-push	The `terraform remote push` command is used to push a cached local copy of the state to a remote storage server.

Command: remote push

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

Usage: terraform remote push

The remote push command is invoked without options to upload the local cached state to the remote storage server.