This is a tutorial to set up a fully configured remote environment with VSCode Dev Containers.
- Windows: Docker Desktop 2.0+ on Windows 10 Pro/Enterprise. Windows 10 Home (2004+) requires Docker Desktop 2.3+ and the WSL 2 back-end.
- macOS: Docker Desktop 2.0+.
- Linux: Docker CE/EE 18.06+ and Docker Compose 1.21+
Follow the instructions here to install Docker to your operating system.
For better performance, use WSL.
Follow the instructions here to get started with WSL.
Follow the instructions here to open WSL in VSCode.
After installing WSL, enable docker support on it.
Make sure that
WSL 2is installed with:wsl --list --verbose
Make sure that the installed distribution is running
To change versions, use the command:wsl --set-version <distro name> 2
<distro name>with the name of the Linux distribution that you want to update. For example,
wsl --set-version Ubuntu 2will set your Ubuntu distribution to use
You can clone the terminal, and you can work directly with VSCode. To work with Github in VSCode, follow the instructions here.
If you cloned the repository with VSCode, you can skip this step.
- Open VSCode.
- Go to File > Open Folder.
- Select your GitHub repository.
- Click this green button:
- Click Reopen in Container.
- Wait a few minutes until the Dev Container is ready.
The environnement contains
poetry, preinstalled system and python dependencies, and recommended extensions, including XSOAR VSCode extension
Follow the XSOAR VSCode extension to get started with our features.
If you are not familiar with using
VSCode, follow the Getting Started guide.
Docker is not native for Mac or in Windows, there could be performance issues.
If facing performance issues, try the following:
- If you're in Windows, use WSL2.
- Update your
If there are errors in opening the dev container, try the following:
- Update your
- Clean up your