Share via

Remote Windows Game Development quickstart guide

The Xbox PC Toolbox application is in preview. Please reach out to your Xbox contact if you would like to find out more.

Cleanup of other preview iterations

Note

You can skip this section if you were never part of previous previews. Otherwise, follow the cleanup instructions

Using a PowerShell Script

Download the script to both devices by clicking on the Cleanup Script

  1. For the Development PC: Download the script
    • Open PowerShell or PowerShell 7 as an Administrator
    • Go to the downloaded path for example: “cd downloads”
    • Run the following exact command

      pwsh Remove-XboxPCDeviceArtifacts.ps1 -Target devpc
  1. For the Target Device: Copy the script to target device via USB stick or nearby sharing
    • Open PowerShell or Powershell 7 as an Administrator
    • Go to the downloaded path for eg. “cd downloads”
    • Run the following exact command

pwsh Remove-XboxPCDeviceArtifacts.ps1 -Target targetdevice

Installation and setup

Setup Prerequisites

  • Internet access is required on both devices during setup
  • Installation of the Xbox PC Toolbox app from the MS Store on Windows is required on both devices
  • Devices must share the same local network and be able to ping each other
  • The Xbox PC Toolbox application must be accquired from the RETAIL sandbox. Ater acquisition and setup, you may change to any developer sandbox.
  • Only devices running Windows 10 or Windows 11, Home or Pro editions are supported
  • Physical access to both devices is required during setup
  • Azure Active Drectory(AAD) joined target devices are not supported.
  • Administrator level access is required on both devices to execute setup steps

Changes the Xbox PC Toolbox setup makes on your devices

DevPC configuration changes applied during setup

  • Enables Developer Mode.
  • PowerShell modules are installed into your documents folder
  • Sets Networking Profile of chosen network adapter to private.
  • Enables File and Printer Sharing & Network Discovery over private networks.
  • Enables WinRM.
  • Installs OpenSSH Client and seta ssh-agent to automatically start on your system.
  • Creates a set of SSH keys to be used.

Target device configuration changes applied during setup

  • Enables Developer Mode.
  • PowerShell modules are installed into your documents folder
  • Sets Networking Profile of chosen network adapter to private.
  • Enables File and Printer Sharing & Network Discovery over private networks.
  • Enables WinRM.
  • Installs OpenSSH Server and set sshd to automatically start on the system.
  • Adds firewall rule for SSH server over port 22.
  • Removes sleep timeout and display timeout on the device.
  • Configures SSH to work only via PowerShell subsystem and key-based authentication.
  • Installs Visual C++ Runtime Redistributable.
  • Sets netsh https rule over port 4275 for wdEndpoint to listen for incoming connection.

For Known Issues and Frequently Asked Questions, visit Remote Windows game development FAQ guide

  • Last updated on