Environment Setup:

Local Development (Windows 10)

Configure a local Windows 10 development environment.

Here's what you'll need:

  • 64-bit Windows 10 Pro, Enterprise, or Education (Version 1607 or newer)
  • Hardware-accelerated virtualisation enabled in the system BIOS/EFI
  • Docker Desktop for Windows

Contents

Blacklisted versions of Windows 10

Do not use Windows 10 version 1903 to build Windows container images. There is a known bug in Windows Server version 1903 and Windows 10 version 1903 that prevents Docker from building images larger than the default limit of 20GB. This version of Windows should be avoided when building Unreal Engine container images.

Optimal performance warning for Windows containers

If you are using Windows 10 to build and run Windows containers then Docker Desktop for Windows will use Hyper-V isolation mode by default, which suffers from a number of performance and stability issues that make it poorly suited for use with Unreal Engine containers. If you are running Windows 10 version 1809 or newer then it is strongly recommended that you instruct Docker to use process isolation mode instead. If you are running an older version of Windows 10 that does not support this feature then it is recommended that you update to Windows 10 version 1809 or newer, or alternatively use Windows Server to build and run Windows containers in process isolation mode.

Installing Docker

Download the Docker Desktop for Windows installer and follow the installation instructions. Once the application is installed and running it will automatically create Hyper-V virtual machines suitable for running both Windows containers and Linux containers. Unless you have enabled support for the experimental Linux containers on Windows (LCOW) feature, the two container platforms are treated as separate “modes” that Docker Desktop for Windows can switch between. The default mode after installation is Linux container mode.

Configuring Docker for building and running Windows containers

Remember to switch to Windows containers mode before following these instructions.

By default, Docker Desktop for Windows imposes a 20GB size limit on container images, which is too low for building and running Unreal Engine containers. You will need to follow the instructions provided by Microsoft to increase the maximum container disk size. The 120GB limit specified in the instructions is sufficient for building and running Unreal Engine container images that do not include the Engine Tools, but a limit of 300GB is recommended for building container images that do include the Engine Tools.

Configuring Docker for building and running Linux containers

By default, Docker Desktop for Windows will use a Linux virtual machine running the Moby VM image to run the Docker daemon. This is the configuration that Microsoft currently recommends due to the experimental nature of LCOW. The default configured resource limits for the Moby VM are too low for building and running Unreal Engine containers. You will need to use the Advanced tab of the Docker settings pane to increase the resource allocations: