Running builds in Hyper-V virtual machines

AppVeyor BYOC allows connecting an existing server with Hyper-V (your Windows 10 workstation, cloud VM or the server in your LAN) and running builds in Windows or Linux VMs.


  • Supported Hyper-V host operating systems:
    • Windows 10 Version 1803 and later
    • Windows Server 2016 and later
    • Azure Dsv3-series VMs with nested virtualization enabled
  • Supported guest operating systems:
    • Windows Server 2019
    • Windows Server 2016
    • Ubuntu 18.04
  • Hyper-V feature enabled on the host

Assisted setup

Following cloud configuration wizard is the fastest and the easiest way to configure Docker computer to run your builds. At the end of the wizard you’ll be given a few commands that you run on the Hyper-V host to get it up and running in AppVeyor.

In AppVeyor web portal:

  • Select Self-hosted jobs in the top menu;
  • Click Add cloud to start “Add your own cloud” wizard;
  • Choose Hyper-V;
  • Select Base image to configure image builder and click Next;
  • Follow the instructions. Connect-AppVeyorToHyperV cmdlet (source) will build master image (.vhdx), configure a new cloud, install AppVeyor Host Agent on the computer and connect it to the cloud.
  • Click Finish to return to BYOC page and make sure the status of created cloud is Active meaning Host Agent was able to connect to AppVeyor.
  • Update project settings to run builds on your computer.
Did you know that you can edit this page on GitHub and send us a Pull Request?