Manually Installing the Remote Agent

Index of All Documentation » Wing Pro Reference Manual » Remote Development »

If for some reason you cannot use Wing's automated installation of the remote agent, for example if Wing does not recognize the type of the remote system, you can install it manually as follows.

  • Find the Debugger Package most closely matching your remote host at, copy it to the remote host, and unpack it. The resulting directory can be renamed if desired.
  • Run chmod +x wingdb in the remote agent install directory to make that file executable
  • Set Installation Directory under the Advanced tab in your remote host configuration to match the remote agent install location (this should be the full path of the directory that contains

If you plan to use wingdbstub to initiate debug from outside of Wing, as described in Debugging Externally Launched Remote Code you'll also need to:

  • Copy from your Wing installation to the remote host and place it in the remote agent install directory (same directory as
  • Set WINGHOME in to the full path of the remote agent install directory
  • Set kWingHostPort in to localhost:50050 (assuming default debug port settings)
  • Copy the wingdebugpw file from the host where the IDE is into the remote agent install directory on the remote system. The file is in the Settings Directory, which is listed in Wing's About box, accessed from the Help menu.

Once this is done, Wing should be able to probe and use the remote host from Remote Hosts in the Project menu.

Running on Unsupported OSes

These instructions should work on any system that has Python installed. If the remote host is not one that Wing fully supports, you will still be able to edit, search, and manage files, run unit tests, execute version control operations, and run OS commands.

However, debugging or running a remote Python Shell will not work on unsupported OSes unless you compile the debugger core yourself (requires signed NDA). Or contact us to request support for your device.