Unreal Engine 5 Documentation has been moved to the Epic Developer Community

HoloLens Device Quick Start

Instructions for configuring and running the HoloLens Device with Unreal Engine 4.

Choose your operating system:

Windows

macOS

Linux

Prerequisite Topics

In order to understand and use the content on this page, make sure you are familiar with the following topics:

Device_ScreenShot.png

You can deploy and run an Unreal app directly on the device.

1 - Verify System Requirements

Steps

  1. Verify that you have installed the necessary prerequisites to run the HoloLens 2. See HoloLens 2 Prerequisites for more information.

2 - Required Setup

Before you can deploy an Unreal application to the HoloLens, you must configure the HoloLens and become familiar with its basic operations.

For more information on initial HoloLens setup and configuration, see Get started with HoloLens .

Steps

  1. Make sure that your HoloLens is charged.

  2. If this is your first time launching the HoloLens, turn it on and proceed with the calibration process.

  3. Log in with your account or create a new account .

  4. On the HoloLens, open the Settings menu

    SettingsMenu.jpg

  5. Open Update & Security .

    UpdateandSecurity.jpg

  6. Open For developers .

    UpdateForDevelopers.jpg

  7. Enable Use developer features .

    EnableDeveloperFeatures.jpg

  8. Enable the Device Portal .

    EnableDevicePortal.jpg

3 - Install a Package to the HoloLens 2

If you do not already have an app built and available for the HoloLens, see Packaging an App for the HoloLens 2 for more information on packaging an app for the HoloLens 2.

In the steps you will load two files, an *.appxbundle file and an *.appx file. The *.appxbundle file is the game's package. The *.appx file is the dependency package containing supporting files for the target architecture (arm64 or x64). The dependency package only needs to be installed a single time per device. If you have already installed the dependency file, just continue with the installation without selecting an optional package. If you reflash your device, you will lose everything that had been deployed to the device, including the dependency packages.

  1. In your browser, enter 127.0.0.1:10080 to open the Windows Device Portal .

    Ensure that your device is plugged into your PC over USB, and that IPOverUSB is installed from the Windows 10 SDK.

    DevicePortal.png

  2. In the Windows Device Portal , select Views > Apps from the toolbar.

    DeployApps2.png

  3. Click the Choose File button, and browse to the location of your project, such as \Unreal Projects\TestProject\Hololens .

    ChooseFileButton.png

    BrowseToAppxPackage.png

  4. Select the .appxbundle file to specify the package you want to install.

    ChooseAppxBundle.png

  5. Select the Allow me to select optional packages option, and select Next .

    The *.appx file is the dependency package and only needs to be installed a single time per device. If you have already installed the dependency file, just continue with the installation without selecting an optional package.

    CheckSelectOptionalPackages.png

  6. Select the Choose File button, and browse to the location of your project, such as \Unreal Projects\TestProject\Hololens .

    ChooseOptionalPackage_ChooseFileButton.png

    BrowseToOptionalPackage.png

  7. Select the *.appx file for the platform you are targeting (x64 for the Emulator, arm64 for the device), and click Next .

    ChooseAppx.png

  8. Click the Install button.

    InstallPackages_Device.png

  9. Wait for the app to finish installing.

    InstallationProgress.png Success_PackageRegistered.png

  10. Once the app installation is complete, scroll through All Apps on the to find your app.

    AllApps.png AppOnDevice.png

4 - On Your Own!

Try running the new Unreal app on your HoloLens.

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