docs/content/admin/installation/setting-up-a-github-enterprise-server-instance/installing-github-enterprise-server-on-hyper-v.md

title, intro, redirect_from, versions, type, topics, shortTitle

title	intro	redirect_from	versions	type	topics	shortTitle
Installing GitHub Enterprise Server on Hyper-V	To install {% data variables.product.prodname_ghe_server %} on Hyper-V, you must deploy onto a machine running Windows Server 2008 through Windows Server 2019.	/enterprise/admin/guides/installation/installing-github-enterprise-on-hyper-v /enterprise/admin/installation/installing-github-enterprise-server-on-hyper-v /admin/installation/installing-github-enterprise-server-on-hyper-v	ghes *	tutorial	Administrator Enterprise Infrastructure Set up	Install on Hyper-V

Prerequisites

• {% data reusables.enterprise_installation.software-license %}
• You must have Windows Server 2008 through Windows Server 2019, which support Hyper-V.
• Most actions needed to create your virtual machine (VM) may also be performed using the Hyper-V Manager. However, we recommend using the Windows PowerShell command-line shell for initial setup. Examples using PowerShell are included below. For more information, see the Microsoft guide "Getting Started with Windows PowerShell."

Hardware considerations

{% data reusables.enterprise_installation.hardware-considerations-all-platforms %}

Downloading the {% data variables.product.prodname_ghe_server %} image

{% data reusables.enterprise_installation.download-license %} {% data reusables.enterprise_installation.download-appliance %} 4. Under "{% data variables.product.prodname_dotcom %} On-premises", select the "Select your hypervisor" dropdown menu and click Hyper-V (VHD). 5. Click Download for Hyper-V (VHD).

Creating the {% data variables.product.prodname_ghe_server %} instance

{% data reusables.enterprise_installation.create-ghe-instance %}

1. In PowerShell, create a new Generation 1 virtual machine, configure the size based on your user license count, and attach the {% data variables.product.prodname_ghe_server %} image you downloaded. For more information, see "New-VM" in the Microsoft documentation.

PS C:\> New-VM -Generation 1 -Name VM_NAME -MemoryStartupBytes MEMORY_SIZE -BootDevice VHD -VHDPath PATH_TO_VHD  

{% data reusables.enterprise_installation.create-attached-storage-volume %} Replace PATH_TO_DATA_DISK with the path to the location where you create the disk. For more information, see "New-VHD" in the Microsoft documentation.

PS C:\> New-VHD -Path PATH_TO_DATA_DISK -SizeBytes DISK_SIZE

3. Attach the data disk to your instance. For more information, see "Add-VMHardDiskDrive" in the Microsoft documentation.

PS C:\> Add-VMHardDiskDrive -VMName VM_NAME -Path PATH_TO_DATA_DISK

4. Start the VM. For more information, see "Start-VM" in the Microsoft documentation.

PS C:\> Start-VM -Name VM_NAME

5. Get the IP address of your VM. For more information, see "Get-VMNetworkAdapter" in the Microsoft documentation.

PS C:\> (Get-VMNetworkAdapter -VMName VM_NAME).IpAddresses

6. Copy the VM's IP address and paste it into a web browser.

Configuring the {% data variables.product.prodname_ghe_server %} instance

{% data reusables.enterprise_installation.copy-the-vm-public-dns-name %} {% data reusables.enterprise_installation.upload-a-license-file %} {% data reusables.enterprise_installation.save-settings-in-web-based-mgmt-console %} For more information, see "Configuring the {% data variables.product.prodname_ghe_server %} appliance." {% data reusables.enterprise_installation.instance-will-restart-automatically %} {% data reusables.enterprise_installation.visit-your-instance %}

Further reading

• "System overview"{% ifversion ghes %}
• "About upgrades to new releases"{% endif %}