Read These First

Windows containers primer

The implementation-agnostic information from this page has migrated to the Unreal Containers community hub. You can find the new version here: Key Concepts: Windows Containers.

Details specific to ue4-docker:

Due to the performance and stability issues currently associated with containers running in Hyper-V isolation mode, it is strongly recommended that process isolation mode be used for building and running Windows containers. This necessitates the use of Windows Server as the host system (or Windows 10 version 1809 or newer for development and testing purposes) and requires that all container images use the same Windows version as the host system. A number of ue4-docker commands provide specific functionality to facilitate this:

  • The ue4-docker build command will automatically attempt to build images based on the same kernel version as the host system, and will default to process isolation mode if the operating system version and Docker daemon version allow it. Hyper-V isolation mode will still be used if the user explicitly specifies a different kernel version than that of the host system or explicitly requests Hyper-V isolation mode.

  • The ue4-docker setup command automates the configuration of Windows Server hosts, in order to provide a smoother experience for users who migrate their container hosts to the latest versions of Windows Server as they are released.