28 lines
816 B
Markdown
28 lines
816 B
Markdown
|
---
|
||
|
|
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.
|
||
|
|
---
|
||
|
|
|
||
|
|
# 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](/docs/commands/remote-config.html) 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.
|
||
|
|
|