Deploy and debug your .NET MAUI app on Windows

You can use your local Windows development computer to deploy and debug a .NET Multi-platform App UI (.NET MAUI) app. This article describes how to configure Windows to debug a .NET MAUI app.

Configure Windows

You must enable Developer Mode in Windows. Both Windows 10 and Windows 11 are supported.

Developer mode settings in Windows 11 for MAUI .NET Windows app.

Windows 11

Developer Mode is enabled in Settings app, under Privacy & security > For developers. To enable Developer Mode in Windows 11:

  1. Open the Start Menu.
  2. Type Developer settings in the search box and select it.
  3. Turn on Developer Mode.
  4. If you receive a warning message about Developer Mode, read it, and select Yes if you understand the warning.

Windows 10

Developer Mode is enabled in Settings app, under Update & Security > For developers. To enable Developer Mode in Windows 10:

  1. Open the Start Menu.
  2. Search for Developer settings, select it.
  3. Turn on Developer Mode.
  4. If you receive a warning message about Developer Mode, read it, and select Yes if you understand the warning.

Target Windows

In Visual Studio, set the Debug Target to Framework (...) > net6.0-windows. There is a version number in the item entry, which may or may not match the following screenshot:

Visual Studio debug target set to Windows for .NET MAUI app using .NET 6.

In Visual Studio, set the Debug Target to Framework (...) > net7.0-windows. There is a version number in the item entry, which may or may not match the following screenshot:

Visual Studio debug target set to Windows for .NET MAUI app using .NET 7.