2016-01-19 18:08:53 +00:00
|
|
|
---
|
|
|
|
layout: "docs"
|
|
|
|
page_title: "Hyper-V Provider"
|
|
|
|
sidebar_current: "providers-hyperv"
|
|
|
|
description: |-
|
|
|
|
Vagrant comes with support out of the box for Hyper-V, a native hypervisor
|
|
|
|
written by Microsoft. Hyper-V is available by default for almost all
|
2016-11-29 15:34:16 +00:00
|
|
|
Windows 8.1 and later installs.
|
2016-01-19 18:08:53 +00:00
|
|
|
---
|
|
|
|
|
|
|
|
# Hyper-V
|
|
|
|
|
|
|
|
Vagrant comes with support out of the box for [Hyper-V](https://en.wikipedia.org/wiki/Hyper-V),
|
|
|
|
a native hypervisor written by Microsoft. Hyper-V is available by default for
|
2016-11-29 15:34:16 +00:00
|
|
|
almost all Windows 8.1 and later installs.
|
2016-01-19 18:08:53 +00:00
|
|
|
|
2016-08-19 16:32:16 +00:00
|
|
|
The Hyper-V provider is compatible with Windows 8.1 and later only. Prior versions
|
2016-01-19 18:08:53 +00:00
|
|
|
of Hyper-V do not include the necessary APIs for Vagrant to work.
|
|
|
|
|
|
|
|
Hyper-V must be enabled prior to using the provider. Most Windows installations
|
2017-10-18 21:34:14 +00:00
|
|
|
will not have Hyper-V enabled by default. Hyper-V is available by default for
|
|
|
|
almost all Windows Enterprise, Professional, or Education 8.1 and later installs.
|
2018-03-22 16:57:43 +00:00
|
|
|
To enable Hyper-V, go to "Programs and Features", click on "Turn Windows
|
|
|
|
features on or off" and check the box next to "Hyper-V". Or install via
|
|
|
|
PowerShell with:
|
2016-11-29 15:34:16 +00:00
|
|
|
|
2018-05-30 10:11:14 +00:00
|
|
|
<code>Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All</code>
|
2016-01-19 18:08:53 +00:00
|
|
|
|
2017-10-18 21:34:14 +00:00
|
|
|
See official documentation [here](https://docs.microsoft.com/en-us/virtualization/hyper-v-on-windows/quick-start/enable-hyper-v).
|
|
|
|
|
2016-01-19 18:08:53 +00:00
|
|
|
<div class="alert alert-warning">
|
|
|
|
<strong>Warning:</strong> Enabling Hyper-V will cause VirtualBox, VMware,
|
|
|
|
and any other virtualization technology to no longer work. See
|
|
|
|
<a href="http://www.hanselman.com/blog/SwitchEasilyBetweenVirtualBoxAndHyperVWithABCDEditBootEntryInWindows81.aspx">this blog post</a>
|
|
|
|
for an easy way to create a boot entry to boot Windows without Hyper-V
|
|
|
|
enabled, if there will be times you will need other hypervisors.
|
|
|
|
</div>
|