The Remote Development extension pack allows you to open any folder in a container, on a remote machine, or in the Windows Subsystem for Linux (WSL) and take advantage of VS Code's full feature set. Since this lets you set up a full-time development environment anywhere, you can:
Start quickly with the most recent versions of Word, Excel, PowerPoint, Outlook, OneNote and OneDrive —combining the familiarity of Office and the unique Mac features you love. Be more productive Find the feature you need fast and create documents more easily with built-in automated design and research tools. Google's free Chrome Remote Desktop service makes it dead-simple to get on any computer — Windows, Mac, Linux, or Chrome OS — from practically any other desktop or mobile device.
- Develop on the same operating system you deploy to or use larger, faster, or more specialized hardware than your local machine.
- Quickly swap between different, isolated development environments and safely make updates without worrying about impacting your local machine.
- Help new team members / contributors get productive quickly with easily spun up, consistent development containers.
- Take advantage of a Linux based tool-chain right from the comfort of Windows from a full-featured development tool.
No source code needs to be on your local machine to gain these benefits since Remote Development runs commands and extensions directly on the remote machine.
This Remote Development extension pack includes three extensions:
- Remote - SSH - Work with source code in any location by opening folders on a remote machine/VM using SSH. Supports x86_64, ARMv7l (AArch32), and ARMv8l (AArch64) glibc-based Linux, Windows 10/Server (1803+), and macOS 10.14+ (Mojave) SSH hosts.
- Remote - Containers - Work with a sandboxed toolchain or container based application by opening any folder mounted into or inside a container.
- Remote - WSL - Get a Linux-powered development experience from the comfort of Windows by opening any folder in the Windows Subsystem for Linux.
The Remote SSH extension at work:
System Requirements
Local: See the minimum requirements for VS Code. Windows support in Remote - Containers requires Windows 10 Professional or Enterprise is due to the requirements of Docker Desktop. See installation steps for additional details.
Remote host / container / WSL support:
- x86_64 / ARMv8l (AArch64) / ARM7l (AArch32) Debian/Raspbian 9+, Ubuntu 16.04+, Ubuntu IoT 18.04+, CentOS / RHEL 7+ SSH hosts, containers, or WSL distributions.
- x86_64 Alpine Linux 3.7+ containers or WSL distributions (no SSH support yet).
Additional SSH support:
- Windows 10 / Server 2016/2019 (1803+) using the official OpenSSH Server.
- macOS 10.14+ (Mojave) SSH hosts with Remote Login enabled.
Other glibc based Linux SSH Hosts, containers, or WSL distributions may work if they have needed prerequisites.
Some extensions installed on ARMv7l (AArch32) and ARMv8l (AArch64) devices may not work due to the use of x86 native code in the extension. Similarly, extensions installed in Alpine Linux containers or the Alpine WSL distribution may not work due to glibc dependencies in native code inside the extension. See the Remote Development and Linux article for details.
Installation
Install VS Code or VS Code Insiders and this extension pack. On Windows, be sure to check Add to PATH when asked to Select Additional Tasks during installation.
Remote - SSH: Install an OpenSSH compatible SSH client.
Remote - WSL: Install the Windows Subsystem for Linux along with your preferred Linux distribution. (Note that WSL2 support is experimental.)
Remote - Containers: Install and configure Docker for your operating system.
Windows / macOS:
- Install Docker Desktop 2.0+ for Mac/Windows. (Docker Toolbox is not supported, but Docker does not need to be running if you use a remote host.)
- Right-click on the Docker task bar item and update Settings / Preferences > Shared Drives / File Sharing with any source code locations you want to open in a container. See tips and tricks for details.
Linux:
- Follow the official install instructions for Docker CE/EE 18.06+. If you use Docker Compose, follow the Docker Compose 1.21+ install directions.
- Add your user to the
dockergroup by using a terminal to run:sudo usermod -aG docker $USERSign out and back in again so this setting takes effect.
Working with Git? Here are three tips to consider:
- If you are working with the same repository folder in Windows and WSL or a container, be sure to set up consistent line endings. See tips and tricks to learn how.
- In WSL, you can also avoid passwords by configuring WSL to use the Windows Git credential manager. See tips and tricks to for details.
- For containers, if you clone using a Git credential manager, your container should already have access to your credentials! If you use SSH keys, you can also opt-in to sharing them. See Sharing Git credentials with your container for details.
Getting started
Check out one of the following quick starts to get going.
Available commands
Another way to learn what you can do with the Remote Development extensions is to browse the commands each of them provide. Press F1 to bring up the Command Palette and type in Remote- for a full list of commands.
You can also click on the Remote 'Quick Access' status bar item in the lower left corner to get a list of the most common commands.
For more information, please see the extension pack documentation.
Questions, Feedback, Contributing
Have a question or feedback?
- See the documentation or the troubleshooting guide.
- Up-vote a feature or request a new one, search existing issues, or report a problem.
- Contribute a development container definition for others to use
- Contribute to our documentation
- ...and more. See our CONTRIBUTING guide for details.
Or connect with the community...
Telemetry
The Visual Studio Code Remote Development extension pack and its related extensions collect telemetry data to help us build a better experience working remotely from VS Code. We only collect data on which commands are executed. We do not collect any information about image names, paths, etc. The extension respects the telemetry.enableTelemetry setting which you can learn more about in the Visual Studio Code FAQ.
Install Microsoft Remote Desktop Mac
License
Microsoft Remote Desktop Mac Won't Install
By downloading and using the Visual Studio Remote Development extension pack and its related components, you agree to the product license terms and privacy statement.