To install GitHub Enterprise on Hyper-V, you must have a machine running Windows 8 Pro or Windows 8 Enterprise and then deploy the GitHub Enterprise disk image to it.

Requirements

Before installing GitHub Enterprise on Hyper-V, ensure you meet these software and hardware requirements.

Software

  • GitHub Enterprise Hyper-V disk image (VHD) and license files - The appliance and license required to run GitHub Enterprise are available from the GitHub Enterprise download page.
  • Windows 8 Pro or Windows 8 Enterprise - Both of these operating systems support Hyper-V servers.
  • Hyper-V Manager - This software provides a graphical interface for configuring Hyper-V servers.

Hardware

  • For your root storage, we require at least an 80 GB virtual disk.
  • For your attached storage device, we recommend a high-performance disk, such as a SAN or a local SSD.

Based on your seat count, we recommend this hardware configuration:

Seats vCPUs Memory Attached Storage Root Storage
0-500 2 16 GB 100 GB 80 GB
500-3000 4 32 GB 250 GB 80 GB
3000-5000 8 64 GB 500 GB 80 GB

These are minimum recommendations and more resources may be required depending on your usage.

Note: The root disk cannot be resized.

Warning: We recommend you use webhooks to fetch repository changes for continuous integration (CI) or similar systems. Regular automatic checks, or polling, will significantly reduce the scalability of your instance.

An encrypted data volume provides an extra level of security by ensuring that any data you write to your instance is protected. There's a slight peformance impact when using encrypted disks. If you decide to encrypt your volume, we strongly recommend doing so before starting your instance for the first time. For more information, see the documentation on BitLocker Drive Encryption.

If you decide to enable encryption after you've configured your instance, you will need to migrate your data to the encrypted volume, which will incur some downtime for your users.

Download the GitHub Enterprise VM

  1. Navigate to the GitHub Enterprise download page.

  2. To download your license file, click Download license.

  3. Click Get the latest release.

  4. Select GitHub On-premises, then click Hyper-V (VHD).

  5. Click Download for Hyper-V (VHD).

Import the GitHub Enterprise VM

  1. Start the Hyper-V Manager.

  2. Create new VM menu optionIn the Actions menu, click New > Virtual Machine....

  3. New VM creation instructionsClick Next.

  4. Name VM stageIn the Name field, type a name for your virtual machine.

  5. Name VM stageSelect Generation 1.

  6. Configure memory storage pageConfigure the VM's memory storage based on your seat count. For more information, see the hardware requirements.

  7. Configure memory storage pageIn the Connection field, select a network available to your Hyper-V host to map to the virtual network interface in the VM.

  8. Import GHE VHDSelect Use an existing virtual hard disk. On your computer, locate where the Hyper-V VHD was downloaded.

  9. Complete configurationClick Finish. Leave the VM powered off.

Configure additional block storage

  1. Settings menuIn the right pane, click Settings.

  2. SCSI Controller menu optionIn the left pane, click SCSI Controller.

  3. Add new hard driveSelect Hard Drive, then click Add.

  4. Create new hard drive imageSelect Virtual hard disk, then click New.

  5. Skip first hard drive settingClick Next.

  6. Creating a VHDX driveFor the hard disk format, select VHDX.

  7. Creating a dynamically expanding driveFor the hard disk type, select Dynamically expanding.

  8. Naming your virtual hard diskType a name for your virtual hard disk. Either keep the default location, or click Browse... to choose a new destination.

  9. Setting your hard disk's sizeTo create the disk, click Create a new blank virtual hard disk. Configure the size of the hard disk based on your seat count. For more information, see the hardware requirements.

  10. Completing the additionTo start the import, click Finish.

Start the VM

  1. VM start buttonTo start the VM, in the right pane, click Connect....

  2. Network tabAfter a few moments, the GitHub Enterprise management screen will open. Take note of your VM's IP address.

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

  4. Configure the GitHub Enterprise appliance.