open-consul/website/source/docs/commands/snapshot.html.markdown

layout	page_title	sidebar_current
docs	Commands: Snapshot	docs-commands-snapshot

Consul Snapshot

Command: consul snapshot

The snapshot command has subcommands for saving, restoring, and inspecting the state of the Consul servers for disaster recovery. These are atomic, point-in-time snapshots which include key/value entries, service catalog, prepared queries, sessions, and ACLs. This command is available in Consul 0.7.1 and later.

Snapshots are also accessible via the HTTP API.

Usage

Usage: consul snapshot <subcommand>

For the exact documentation for your Consul version, run consul snapshot -h to view the complete list of subcommands.

Usage: consul snapshot <subcommand> [options] [args]

  # ...

Subcommands:

    agent      Periodically saves snapshots of Consul server state
    inspect    Displays information about a Consul snapshot file
    restore    Restores snapshot of Consul server state
    save       Saves snapshot of Consul server state

For more information, examples, and usage about a subcommand, click on the name of the subcommand in the sidebar or one of the links below:

• [agent] (/docs/commands/snapshot/agent.html) (Consul Enterprise only)
• [inspect] (/docs/commands/snapshot/inspect.html)
• restore
• save

Basic Examples

To create a snapshot and save it as a file called "backup.snap":

$ consul snapshot save backup.snap
Saved and verified snapshot to index 8419

To restore a snapshot from a file called "backup.snap":

$ consul snapshot restore backup.snap
Restored snapshot

To inspect a snapshot from the file "backup.snap":

$ consul snapshot inspect backup.snap
ID           2-5-1477944140022
Size         667
Index        5
Term         2
Version      1

To run a daemon process that periodically saves snapshots (Consul Enterprise only):

$ consul snapshot agent

For more examples, ask for subcommand help or view the subcommand documentation by clicking on one of the links in the sidebar.