Features at a glance
This container image source supports the features listed below. For an explanation of what each of these features denotes and to compare this source to other available sources, see the page Available Image Sources.
- Distribution: Dockerfiles, Pre-built images
- Host platforms: Linux, Windows, macOS
- Container platforms: Linux development images
- Hardware acceleration: NVIDIA GPU support
- Unreal Engine build tools: Installed Build
- Unreal Engine target platforms: Windows native, Linux native
About this container image source
In April 2021, Epic Games announced on the Unreal Engine public roadmap the intention to include official support for containers in Unreal Engine 4.27. This support subsequently landed in Unreal Engine 4.27.0 in August 2021. This version and all subsequent versions of the Unreal Engine ship with a set of official container images which includes both development images and runtime images, along with a number of supporting container images for other components related to various Unreal Engine use cases:
The development container images that ship with the Unreal Engine are derived from the ue4-docker project. The standalone Dockerfiles for these images are generated using the export and combination functionality described in the blog post Preview the future of the ue4-docker project.
The Linux runtime container images that ship with the Unreal Engine are derived from the ue4-runtime project. A Windows runtime container image is also provided based on the code presented in the blog posts Offscreen rendering in Windows containers and Enabling vendor-specific graphics APIs in Windows containers.
The source code for all of the official container images can be found under the Engine/Extras/Containers/Dockerfiles directory of the Unreal Engine source tree. Note that if you have downloaded the Unreal Engine source code from GitHub then you will need to run
Setup.bat (under Windows) or
Setup.sh (under other platforms) to retrieve the source files, since these files are currently treated as binary dependencies and are not included in the git repository itself.
The code for the official container images was contributed to the Unreal Engine by Dr Adam Rehn, the creator of the ue4-docker and ue4-runtime projects and the founder of the Unreal Containers community hub.
The official Unreal Engine documentation features a section covering official container support. The documentation includes an overview of the container images that ship with the Unreal Engine, getting started guides, and how-to guides for specific tasks. To avoid unnecessary duplication of information, the Unreal Engine documentation primarily provides details specific to the official container images and links to the Unreal Containers community hub to provide general context.
Available container images
You can view the full list of available container images and tags here: https://github.com/orgs/EpicGames/packages.
The container image ghcr.io/epicgames/unreal-engine stores tags for both development images and runtime images:
dev-slimtags represent Linux development images.
runtime-pixel-streamingtags represent Linux runtime images.
runtime-windowstag is a manifest list that represents Windows runtime images for different Windows kernel versions.
Using this container image source
Start by reading the Containers Overview page of the Unreal Engine documentation, which provides an overview of container support in the Unreal Engine and lists the official container images that ship with Unreal Engine 4.27 and newer.
Work through the Containers Quick Start guide to pull a pre-built Linux development container image and use it to package an Unreal project.
If you want to build the official images from source (e.g. for a custom version of the Unreal Engine) then check out the How To Guides for step-by-step instructions.