diff --git a/website/content/docs/cli/halt.mdx b/website/content/docs/cli/halt.mdx index a8fdb4075..dcb16a13d 100644 --- a/website/content/docs/cli/halt.mdx +++ b/website/content/docs/cli/halt.mdx @@ -16,9 +16,14 @@ Vagrant will first attempt to gracefully shut down the machine by running the guest OS shutdown mechanism. If this fails, or if the `--force` flag is specified, Vagrant will effectively just shut off power to the machine. -For linux-based guests, Vagrant uses the `shutdown` command to gracefully -terminate the machine. Due to the varying nature of operating systems, the -`shutdown` command may exist at many different locations in the guest's `$PATH`. +For linux-based guests, Vagrant will: + +1. Attempt to detect and use Systemd to execute `systemctl poweroff`; but otherwise, +2. Fallback to using the `shutdown` command to gracefully +terminate the machine. + +Due to the varying nature of operating systems, these executables may exist at many +different locations in the guest's `$PATH`. It is the guest machine's responsibility to properly populate the `$PATH` with directory containing the `shutdown` command.