
<!--
Copyright © Microsoft Corporation
All rights reserved.
Creative Commons Attribution 4.0 License (International): https://creativecommons.org/licenses/by/4.0/legalcode
-->

# Visual Studio Code Remote Development

<table style="width: 100%; border-style: none;"><tr>
<td style="width: 140px; text-align: center;"><a href="https://aka.ms/vscode-remote/download/extension"><img width="128px" src="docs/images/remote-extensionpack.png" alt="Visual Studio Code logo"/></a></td>
<td>
<strong>Visual Studio Code Remote Development</strong><br />
<i>Open any folder in a container, on a remote machine, or in WSL and take advantage of VS Code's full feature set. <strong><a href="https://aka.ms/vscode-remote">Learn more!</a></strong><br />
<strong><a href="https://aka.ms/vscode-remote/download/extension"><img src="docs/images/download.png" alt="Download now!"/></a></strong></i><br>
</td>
</tr></table>

This repository is for providing feedback on the **[Visual Studio Remote Development](https://aka.ms/vscode-remote/download/extension)** extension pack and its related extensions. You can use the repository to report issues or submit feature requests on any of these extensions:

- **[Remote - SSH](https://aka.ms/vscode-remote/download/ssh)**
    - Remote - SSH: Editing Configuration Files
- **[Dev Containers](https://aka.ms/vscode-remote/download/containers)**
- **[WSL](https://aka.ms/vscode-remote/download/wsl)**
- **[Remote - Tunnels](https://marketplace.visualstudio.com/items?itemName=ms-vscode.remote-server)** and the **[Visual Studio Code Server](https://aka.ms/vscode-server-doc)**.

If you are running into an issue with **another extension** you'd like to use with the Remote Development extensions, please raise an issue in the extension's repository. You can reference our [summary](https://aka.ms/vscode-remote/troubleshooting/extensions) of tips for remote related issues and our [extension guide](https://aka.ms/vscode-remote/developing-extensions) to help the extension author get started. 

Issues related to [the Dev Container ecosystem](https://containers.dev/) may be reported in several places. Issues involving [Features](https://github.com/devcontainers/features), [Templates](https://github.com/devcontainers/templates), or [Images](https://github.com/devcontainers/images) can be reported in the relevant repo.  Issues relating to the open source dev container CLI can be reported on [devcontainers/cli](https://github.com/devcontainers/cli). You may use the [dev container spec repository](https://github.com/devcontainers/spec) to file and review issues to shape the direction of development containers and the dev container CLI.

## Documentation

Running into trouble? Wondering what you can do? These articles can help.

- [Overview](https://aka.ms/vscode-remote)
- [Remote Development using SSH](https://aka.ms/vscode-remote/ssh)
- [Developing inside a Container](https://aka.ms/vscode-remote/containers)
- [Developing in WSL](https://aka.ms/vscode-remote/wsl)
- [Tips, Tricks, and Troubleshooting](https://aka.ms/vscode-remote/troubleshooting)

## Releases

VS Code Remote Development extension "stable" releases are tied directly to VS Code releases. Release highlights can be found in [VS Code release notes](https://code.visualstudio.com/updates) which will include a link to [detailed extension release notes](https://github.com/microsoft/vscode-docs/tree/main/remote-release-notes). 

The extensions are developed using the same [development process and schedule](https://github.com/microsoft/vscode/wiki/Development-Process#inside-an-iteration) as VS Code itself. You can see what is planned for the current development iteration in a pinned [planning issue in this repository](https://github.com/microsoft/vscode-remote-release/issues). This issue will include a link to the broader VS Code plan. As with VS Code itself, the extensions will update during a development iteration with changes that are only available in [VS Code Insiders Edition](https://code.visualstudio.com/insiders/).

## Providing Feedback

You can use this repository to:
- [Up-vote a feature or request a new one](https://aka.ms/vscode-remote/feature-requests).
- Search for [existing issues](https://aka.ms/vscode-remote/issues) already reported for potential workarounds.
- [Report a problem](https://aka.ms/vscode-remote/issues/new) if you don't find what you are looking for.

If you have a question, connect with the community using any of these social platforms:

[![Twitter](docs/images/Twitter_Social_Icon_24x24.png)](https://aka.ms/vscode-remote/twitter) [![Stack Overflow](docs/images/so-image-24x24.png)](https://stackoverflow.com/questions/tagged/vscode) [![VS Code Dev Community Slack](docs/images/Slack_Mark-24x24.png)](https://aka.ms/vscode-dev-community) [![VS Code Gitter](docs/images/gitter-icon-24x24.png)](https://gitter.im/Microsoft/vscode)

See our [CONTRIBUTING](https://aka.ms/vscode-remote/contributing) guide for more details.

## License

By downloading and using the Visual Studio Remote Development extension pack and its related extensions, you agree to the product [license terms](https://go.microsoft.com/fwlink/?linkid=2077057) and [privacy statement](https://www.microsoft.com/en-us/privacystatement/EnterpriseDev/default.aspx).

License for this repository:

Copyright © Microsoft Corporation All rights reserved.<br />
Creative Commons Attribution 4.0 License (International): https://creativecommons.org/licenses/by/4.0/legalcode
