vagrant-halt

Halt the currently running Vagrant machine gracefully

$ vagrant halt

$ vagrant halt [id_or_name]

$ vagrant halt [[-f|--force]]

$ vagrant halt [[-f|--force]] [id_or_name]

vagrant halt [options] [name|id]

--force
    Forcefully shuts down the machine. Avoids attempting a graceful shutdown.

[name|id]
    The name or ID of the Vagrant machine to halt. If omitted, all running machines in the Vagrant environment will be halted.

The vagrant halt command gracefully shuts down a running Vagrant machine. It sends an ACPI shutdown signal to the guest operating system, allowing it to cleanly power off. This is preferable to simply powering off the virtual machine using the virtualization provider's tools, as it allows the guest OS to save state and perform necessary shutdown procedures.

If the machine is already halted or doesn't exist, Vagrant will report that it is not running. If the guest OS doesn't respond to the ACPI signal within a reasonable timeout, Vagrant may force a power-off, which is less desirable. It's generally recommended to halt the machine from within the guest OS if possible before using `vagrant halt` as a failsafe.

This command is used for shutting down virtual machines controlled by Vagrant, simulating a regular system shutdown.

If the guest OS is unresponsive, using vagrant halt might hang indefinitely. In such cases, consider using the --force flag, but be aware that this can lead to data loss if the guest OS has not properly saved its state.

After executing vagrant halt, the machine enters a 'powered off' state. To restart the machine, you will need to use vagrant up. Using virtualization tool to start machine won't update Vagrant's state and may cause problems.

It is possible to halt multiple machines in parallel. The Vagrantfile should be configured to support multiple machines. Then you can target a specific machine by specifying its name or ID as a parameter to `vagrant halt`, e.g., `vagrant halt web`. If no name or ID is provided, all running machines in the environment will be halted sequentially (or in parallel based on Vagrantfile config).

The vagrant halt command has been a core part of Vagrant since its early development. It was created to provide a consistent and manageable way to shut down virtual machines managed by Vagrant, ensuring a controlled shutdown process regardless of the underlying virtualization provider (VirtualBox, VMware, etc.).

vagrant up(1), vagrant suspend(1), vagrant destroy(1), shutdown(8)