2013-09-03 18:08:28 +00:00
|
|
|
---
|
2016-01-19 18:08:53 +00:00
|
|
|
layout: "docs"
|
2013-09-06 16:50:43 +00:00
|
|
|
page_title: "vagrant suspend - Command-Line Interface"
|
2013-09-03 18:08:28 +00:00
|
|
|
sidebar_current: "cli-suspend"
|
2016-01-19 18:08:53 +00:00
|
|
|
description: |-
|
|
|
|
|
The "vagrant suspend" command is used to suspend the guest machine Vagrant is
|
|
|
|
|
currently managing.
|
2013-09-03 18:08:28 +00:00
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Suspend
|
|
|
|
|
|
2016-04-12 11:45:10 +00:00
|
|
|
**Command: `vagrant suspend [name|id]`**
|
2013-09-03 18:08:28 +00:00
|
|
|
|
|
|
|
|
This suspends the guest machine Vagrant is managing, rather than fully
|
2016-01-19 18:08:53 +00:00
|
|
|
[shutting it down](/docs/cli/halt.html) or [destroying it](/docs/cli/destroy.html).
|
2013-09-03 18:08:28 +00:00
|
|
|
|
|
|
|
|
A suspend effectively saves the _exact point-in-time state_ of the machine,
|
2016-01-19 18:08:53 +00:00
|
|
|
so that when you [resume](/docs/cli/resume.html) it later, it begins running
|
2013-09-03 18:08:28 +00:00
|
|
|
immediately from that point, rather than doing a full boot.
|
|
|
|
|
|
|
|
|
|
This generally requires extra disk space to store all the contents of the
|
|
|
|
|
RAM within your guest machine, but the machine no longer consumes the
|
|
|
|
|
RAM of your host machine or CPU cycles while it is suspended.
|
