> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XBOX PC Remote Listening Endpoint (wdEndpoint.exe)

> Install and run wdEndpoint.exe on a remote Windows device so it accepts wdRemote commands for PIN pairing, copying files, and deploying and launching games.

> [!NOTE]
>
> The XBOX PC Toolbox app is in preview. Download it from the [Microsoft Store](https://aka.ms/toolboxinstaller) on Windows.

XBOX PC Remote listening endpoint (wdEndpoint.exe) runs on a remote Windows device and accepts commands from the [wdRemote](https://docs.xbox.com/tools/tools-pc/commandlinetools/gr-wdRemote.md) command-line tool on a development PC. Together, these tools support the following workflows for building games on remote Windows devices:

* Establish a trusted, secure connection between a development PC and a remote device using PIN pairing.
* Copy files to and from a remote Windows device and delete remote files.
* Deploy, launch, and terminate games on a remote Windows device.
* Run executables on a remote Windows device.

For an overview of how `wdRemote` and `wdEndpoint` work in the Windows remote development toolset, see [Overview of XBOX PC Remote tools](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/overviews/remote-win-gamedev).

## Install wdEndpoint.exe

You can install wdEndpoint.exe with either the [XBOX PC Toolbox](https://docs.xbox.com/tools/tools-pc/xboxpctoolbox/xboxpctoolbox.md) or WinGet:

`winget install Microsoft.Gaming.RemoteIterationEndpoint `

When you install `wdEndpoint` with XBOX PC Toolbox, it starts automatically when a user signs in to the target device. If you install it using WinGet, start it manually. Run `wdEndpoint` as a nonadministrator to accept commands from `wdRemote`.

## wdEndpoint commands

`wdEndpoint` provides the following commands.

| Command | Description |
| - | - |
| [wdEndpoint /createkeys](#wdEndpoint_createKeys) | Creates the security keys required to enable encryption and device pairing. |
| [wdEndpoint /purgekeys](#wdEndpoint_purgekeys) | Removes all security keys and device pairings from the target device. |
| [wdEndpoint /createpin](#wdEndpoint_createPin) | Creates a PIN used for pairing. |
| [wdEndpoint /pair](#wdEndpoint_pair) | Pairs a remote Windows device with a development PC. |
| [wdEndpoint /noconsole](#wdEndpoint_noconsole) | Runs wdEndpoint without displaying a console window. |

### wdEndpoint /createkeys

Communication between `wdRemote` and `wdEndpoint` is encrypted. Use the `wdEndpoint /createkeys` command to generate the security keys needed for encryption and pairing.

> [!NOTE]
>
> `wdEndpoint /createkeys` requires administrator permissions on the target device.

`wdEndpoint /createkeys`

[Return to the top of this topic.](https://docs.xbox.com/tools/tools-pc/commandlinetools/gr-wdEndpoint.md)

### wdEndpoint /purgekeys

Removes all security keys and device pairings from a target device.

> [!NOTE]
>
> wdEndpoint /purgekeys requires administrator permissions on the target device.

`wdEndpoint /purgekeys`

[Return to the top of this topic.](https://docs.xbox.com/tools/tools-pc/commandlinetools/gr-wdEndpoint.md)

### wdEndpoint /createpin

Creates a PIN used for pairing. Use this PIN as an argument with the `/pair` command.

`wdEndpoint /createpin`

[Return to the top of this topic.](https://docs.xbox.com/tools/tools-pc/commandlinetools/gr-wdEndpoint.md)

### wdEndpoint /pair

Pairs a remote Windows device with a development PC. You can pair in two ways:

1. Run `wdEndpoint /pair` without a PIN. The command generates and displays a PIN, then waits for the PIN to be returned from the development PC. If the PIN isn't returned within two minutes, `wdEndpoint` ends the pairing process.
2. Run `wdEndpoint /pair` with a PIN. This mode doesn’t block or wait. It starts pairing immediately. Create the PIN for the `/pair` command by using the `/createPin` option.

> [!NOTE]
>
> `wdEndpoint /pair` requires administrator permissions on the target device.

`wdEndpoint /pair{:PIN}`

| Option | Description |
| - | - |
| /pair:{PIN} | The PIN to use when pairing in nonblocking mode. |

[Return to the top of this topic.](https://docs.xbox.com/tools/tools-pc/commandlinetools/gr-wdEndpoint.md)

### wdEndpoint /noconsole

Runs `wdEndpoint` without displaying a console window. Display without a console window is useful when starting `wdEndpoint` in scenarios where a visible console window isn't needed.

`wdEndpoint /noconsole`

[Return to the top of this topic.](https://docs.xbox.com/tools/tools-pc/commandlinetools/gr-wdEndpoint.md)

## See also

[wdRemote](https://docs.xbox.com/tools/tools-pc/commandlinetools/gr-wdRemote.md)\
[XBOX PC Remote tools](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/overviews/remote-gamedev-tools)


## Related topics

- [Command-line tools for PC development (contents)](https://docs.xbox.com/tools/tools-pc/commandlinetools/gr-commandlinetools-toc.md)
- [How to use the XBOX PC Remote Tools](https://docs.xbox.com/tools/tools-pc/xbox-pc-remote-tools/how-to-use-tools.md)
- [Commandlinetools](https://docs.xbox.com/tools/tools-pc/commandlinetools/index.md)
- [XBOX PC Remote (wdRemote.exe)](https://docs.xbox.com/tools/tools-pc/commandlinetools/gr-wdRemote.md)
- [Economy version 2 (V2) FAQ](https://docs.xbox.com/tools/tools-pc/xbox-pc-remote-tools/faq.md)