MSDN Community

Your hub for Windows IoT Development

Headless Setup for Windows IoT (Device)

This guide walks you through the process of setting up a Windows IoT device without a directly connected display, keyboard, or mouse. This is crucial for many embedded and industrial scenarios.

Headless setup allows for remote management and deployment, reducing hardware costs and enabling deployment in space-constrained environments.

Prerequisites

Step 1: Prepare the Windows IoT Image

1

Flash the Image

Using a tool like the Windows Imaging and Configuration Designer (ICD) or other flashing utilities, prepare your Windows IoT image onto the target media (e.g., SD card). Ensure the image includes networking capabilities.

For a headless setup, you might need to pre-configure network settings or rely on DHCP. It's highly recommended to ensure your device will obtain an IP address automatically.

Step 2: Initial Boot and Network Connection

2

First Boot

Connect your prepared media to the Windows IoT device and power it on. The device will go through its initial boot sequence. Since it's headless, you won't see any on-screen prompts.

Crucially, ensure your device connects to the network. If using Ethernet, this is usually automatic. For Wi-Fi, you might have pre-configured credentials in your image or need a way to provision them later (advanced topic).

Step 3: Discovering the Device's IP Address

This is often the most challenging part of a headless setup. Here are common methods:

3

Method A: Router DHCP Leases

Log in to your router's administration interface. Look for a "DHCP Client List" or "Connected Devices" section. You should be able to identify your Windows IoT device by its MAC address (if you know it) or a partial hostname. Note down its assigned IP address.

4

Method B: Network Scanning Tools

Use a network scanner utility on your Windows 10/11 PC (e.g., Advanced IP Scanner, Nmap) to scan your local network. This will list all active devices and their IP addresses. Look for a device that corresponds to your Windows IoT device.

5

Method C: Serial Console (if available)

Some IoT boards offer a serial console port. If your device supports this and you have the necessary hardware (USB-to-serial adapter), you can capture boot messages, which often include the IP address obtained via DHCP.

Step 4: Remote Connection

Once you have the IP address, you can remotely connect to your Windows IoT device.

6

Remote Desktop Protocol (RDP)

Windows IoT Enterprise typically has RDP enabled by default for administrator accounts. Open the "Remote Desktop Connection" application on your Windows 10/11 PC and enter the device's IP address.

You'll need the administrator username and password for the device. If this is a fresh image, it might be the default credentials or ones you set during image creation.

mstsc.exe /v:DEVICE_IP_ADDRESS
7

PowerShell Remoting / SSH

For more advanced management or if RDP is not preferred/available, you can enable and use PowerShell Remoting or SSH. This requires prior configuration on the IoT device, often done during image creation or via initial setup scripts.

PowerShell:

Enter-PSSession -ComputerName DEVICE_IP_ADDRESS -Credential USERNAME

SSH:

ssh USERNAME@DEVICE_IP_ADDRESS

Step 5: Post-Setup Configuration

After successfully connecting remotely, you can:

  • Install necessary applications and drivers.
  • Configure device settings, including security and updates.
  • Set up auto-login or Kiosk Mode if required for your application.
  • Establish remote management tools (e.g., IoT Hub provisioning).

Security Note: Always change default passwords and secure your device, especially if it's accessible from untrusted networks. Consider firewall rules and disabling unnecessary services.

Troubleshooting