---
layout: docs
page_title: vagrant suspend - Command-Line Interface
description: |-
  The "vagrant suspend" command is used to suspend the guest machine Vagrant is
  currently managing.
---

⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️
> [!IMPORTANT]  
> **Documentation Update:** Product documentation previously located in `/website` has moved to the [`hashicorp/web-unified-docs`](https://github.com/hashicorp/web-unified-docs) repository, where all product documentation is now centralized. Please make contributions directly to `web-unified-docs`, since changes to `/website` in this repository will not appear on developer.hashicorp.com.
⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️

# Suspend

**Command: `vagrant suspend [name|id]`**

This suspends the guest machine Vagrant is managing, rather than fully
[shutting it down](/vagrant/docs/cli/halt) or [destroying it](/vagrant/docs/cli/destroy).

A suspend effectively saves the _exact point-in-time state_ of the machine,
so that when you [resume](/vagrant/docs/cli/resume) it later, it begins running
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.
