Salesforce Extension for VS Code supports remote development and allows you to use a container as a full-featured development environment. You can open a project mounted into the container and edit with full code completions, code navigation, debugging, and more.
NOTICE: The remote development feature is currently in beta. If you find any bugs or have feedback, open a GitHub issue.
Refer to VS Code documentation if you want to understand more about remote development:
- Use a Docker container as your development container
- Provide full-featured development environment
- Switch your development environment by connecting to a container
To start remote development in dev container, install:
- Docker Desktop. For system requirements and installation instructions, see:
- Latest version of VS Code
- Latest version of VS Code Remote Development Extension Pack.
After you install VS Code and Docker Desktop for your operating system:
- For Windows, set source code locations you want to open in a container. In Docker, right-click and select Settings / Preferences > Shared Drives / File Sharing. See Container tips if you hit trouble with sharing.
- For Linux, see supported platforms. From the terminal, run
sudo usermod -aG docker $USERto add your user to the
dockergroup. This setting takes effect after you sign out and back in again.
- Latest version of the Salesforce Extension Pack
Try a Dev Container with a Sample Project
Let’s use a sample project we provide and try remote development in Docker container with Salesforce Extension.
- Clone the sample repository. The
.devcontainerfolder in the sample project contains the
devcontainer.jsonfile that defines how to configure the dev container, the Dockerfile to use, and the extensions to install. For details, see Creating a devcontainer.json file and devcontainer.json reference.
Remote-Containers: Open Folder in Containerfrom the Command Palette and open the project you cloned. VS code creates a dev container the first time you open the project. After the dev container is built, the project folder in your local system automatically connects and maps into the container, and the side bar shows Dev Container: Salesforce Project. The container will pre-install and configure Java, Git, Salesforce CLI, and all other extensions defined in the
- From the Command Palette, run the
SFDX:Authorize a Dev Hubin the container. From the Output panel (below the editor region), you can get the user code and the verification URL required to complete the authorization. If you are logged in to an org that you don’t want to authorize as a Dev Hub, make sure you log out. Otherwise you’ll not be prompted to enter the credentials for the org you want to authorize. After the authorization is complete, the message
SFDX: Authorize a Dev Hub successfully ranis displayed. In case the success message is not displayed, check if you have the correct user code and try again. If the login page doesn’t prompt you to re-enter the code, terminate the command and run it again. If you are interested, read more about Device Authentication Flow.
SFDX: Create a Default Scratch Org.
You’re all set to use the container as a full-featured development environment.
Open a Project in a Dev Container
- Open an existing project you want to work with or create a new project.
- From the Command Palette, run
Remote-Container: Add Development Container Configuration Files. If you are unable to see this command, make sure that you have installed the latest version of VS Code Remote Development Extension Pack.
- Select Salesforce Project from the list of templates to add
SFDX .devcontainerfolder. VS Code detects the dev container configuration file and prompts you to reopen the project folder in a container.
Reopen in Containerto build a dev container. Now the side bar shows Dev Container: Salesforce Project.
You’ve set up a dev container for an existing project to use as your full-time development environment.
See Also (VS Code documentation):
- Opening a Terminal in a Container
- Debugging in a Container
- Container Specific Settings
- Known Limitations
- Common Questions