Installed Build Reference

This page describes the Installed Build process, including an overview of how to write Installed Build scripts.


Developers are always looking for ways to efficiently deliver build solutions for a variety of hardware profiles and operating systems. An Installed Build is a fully featured engine build that can be redistributed to quickly get your team up and running with the engine. From a technical standpoint, an Installed build contains precompiled binaries for Unreal Editor and a static library for each target platform in development and shipping configurations.

The Installed Build process automates build packages and tools that are needed to make an Installed Build version of Unreal Engine 4 (UE4). In summary, making an Installed Build is the process of setting up default target platforms, compiling UE4 with its tools and editor, running tests, and deploying the Installed Build version of UE4 to targeted platforms.

Making an Installed Build

You can create Installed Builds using the BuildGraph scripting system with the Installed Build script located at [UE4Root]/Engine/Build/InstalledBuild.xml.

To create an Installed Build:

  1. Run the Installed Build Script by invoking the AutomationTool with the following command line, replacing [PLATFORM] with either Win64 or Mac. You can also configure the build using the available Installed Build Script Options.

    BuildGraph -target="Make Installed Build [PLATFORM]" -script=Engine/Build/InstalledEngineBuild.xml -clean
  2. Navigate to the LocalBuilds/Engine/ folder in your Unreal Engine directory to view the Installed Build that you created. If you specified a different directory to publish to, navigate to that directory instead.

Installed Build Script Options

The InstalledEngineBuild.xml script makes an Installed Build with all of the default options and platforms enabled; however, it can be configured using a set of specified options, enabling you to target which platforms to include, where to publish the build to, etc. You can view a list of available options for customizing the build process (along with a list of nodes that will be built), by passing the -listonly option to the script.

The available options are:






A helper option to make an installed build for your host platform only, so that you don't have to disable each platform individually



Include the Win64 target platform



Include the Win32 target platform



Include the Mac target platform



Include the Android target platform



Include the iOS target platform

Enabling this option requires a Mac set up for remote building.



Include the tvOS target platform

Enabling this option requires a Mac set up for remote building.



Include the Linux target platform



Include the Lumin target platform



Include the HTML5 target platform



Include the PS4 target platform

Enabling this option requires the PS4 SDK.



Include the XboxOne target platform

Enabling this option requires the Xbox One SDK.



Derived Data Cache (DDC) for the Engine and Template content can be one of the slowest aspects of the build. If you don't need a stand-alone DDC, you can skip this step by appending -set:WithDDC=false



Generate full debug info for binary editor and packaged application builds



Sign the executables produced if you have to set up your machine to sign executables as part of the build process



Identifier for analytic events to send



Specifies the configurations for packaged applications

Including Additional Files

RuntimeDependencies (set in build.cs files for each module) automatically collate and determine which files are included in an Installed Build. However, there are some required files that cannot be included this way, so they're defined in [UE4Root]/Engine/Build/InstalledEngineFilters.xml. The InstalledEngineFilters XML file also lists patterns of files that should be excluded from the build, determining the types of files that need to be stripped or signed, and finally, deciding what projects to build the DDC for. If you need to include any additional files with the Installed Build, the InstalledEngineFilters XML file is a great place to start.

Select Skin
Help shape the future of Unreal Engine documentation! Tell us how we're doing so we can serve you better.
Take our survey

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback