Installing the Hololens App

Setting up HoloLens to use Windows Device Portal

  1. Power on your HoloLens and put on the device.
  2. Perform the bloom gesture to launch the main menu.
  3. Gaze at the Settings tile and perform the air-tap gesture. Perform a second air-tap to place the app in your environment. The Settings app will launch after you place it.
  4. Select the Update & Security menu item.
  5. Select the For developers menu item.
  6. Enable Use developer features.
  7. Scroll down and enable Device Portal.


Connecting over Wi-Fi

  1. Connect your HoloLens to Wi-Fi.
  2. Look up your device’s IP address.
    • Find the IP address on the device under Settings > Network & Internet > Wi-Fi > Advanced Options.
  3. From a web browser on your PC, go to https://<YOUR_HOLOLENS_IP_ADDRESS>
    • The browser will display the following message: “There’s a problem with this website’s security certificate”. This happens because the certificate which is issued to the Device Portal is a test certificate. You can ignore this certificate error for now and proceed.

Creating a Username and Password

Set up access to Windows Device Portal

The first time you connect to the Device Portal on your HoloLens, you will need to create a username and password.

  1. In a web browser on your PC, enter the IP address of the HoloLens. The Set up access page opens.
  2. Click or tap Request pin and look at the HoloLens display to get the generated PIN.
  3. Enter the PIN in the PIN displayed on your device textbox.
  4. Enter the user name you will use to connect to the Device Portal. It doesn’t need to be a Microsoft Account (MSA) name or a domain name.
  5. Enter a password and confirm it. The password must be at least seven characters in length. It doesn’t need to be an MSA or domain password.
  6. Click Pair to connect to Windows Device Portal on the HoloLens.

If you wish to change this username or password at any time, you can repeat this process by visiting the device security page by navigating to: https://<YOUR_HOLOLENS_IP_ADDRESS>/devicepair.htm.

Security certificate

If you are see a “certificate error” in your browser, you can fix it by creating a trust relationship with the device.

Each HoloLens generates a unique self-signed certificate for its SSL connection. By default, this certificate is not trusted by your PC’s web browser and you may get a “certificate error”. By downloading this certificate from your HoloLens (over USB or a Wi-Fi network you trust) and trusting it on your PC, you can securely connect to your device.

  1. Make sure you are on a secure network (USB or a Wi-Fi network you trust).
  2. Download this device’s certificate from the “Security” page on the Device Portal.
    • Navigate to: https://<YOUR_HOLOLENS_IP_ADDRESS>/devicepair.htm
  3. Install the certificate in the “Trusted Root Certification Authorities” store on your PC.
    • From the Windows menu, type: Manage Computer Certificates and start the applet.
    • Expand the Trusted Root Certification Authority folder.
    • Click on the Certificates folder.
    • From the Action menu, select: All Tasks > Import…
    • Complete the Certificate Import Wizard, using the certificate file you downloaded from the Device Portal.
  4. Restart the browser.

Installing an application package with the Device Portal

  1. Establish a connection from Device Portal to the target HoloLens.
  2. Navigate to the View -> Apps page in the left navigation.
  3. Under Deploy apps click Choose File and browse to the .appx file associated with your application.
  4. Click Install.