Prerequisites and limitations
Prerequisites
You have a project that contains the
.devcontainer
folder with thedevcontainer.json
file that describes the actual dev container.Currently, the code completion for the
devcontainer.json
file is limited. However, the following properties are available:Build properties are supported.
General properties except
otherPortsAttributes
,remoteUser
,updateRemoteUserUID
,userEnvProbe
, andcustomizations
.Docker compose properties are supported.
Lifecycle scripts are supported except
waitFor
.In port attributes only
label
is supported.The minimal host requirements are not supported.
Variables in
devcontainer.json
are supported.
You have access to GitHub.
Your have the Git 2.25 version or later installed on your machine.
You have Docker installed on the machine where a dev container will reside.
The minimal backend requirement for mounting sources is the installed Docker, Colima, Podman, or similar.
Your Docker resources meet the minimal system requirements for the backend.
Additional prerequisites for a remote dev container
The following is a list of additional prerequisites for running your dev container on a remote server:
Docker is installed on both the remote and local machines.
The authorization to a server and Git is done through SSH keys. If you connect to a remote server using a password, generate the key-pair locally and then forward it to a remote server. For more details, refer to Sharing credentials.
Some additional dependencies might be required for a dev container.
If your dev container does not start, make sure you have the following dependencies in the OS of the dev container in the
devcontainer.json
file:curl
unzip
ps
libxext
libxrender
libxtst
libxi
freetype
procps
gcompat
Dev Container limitations
Dev Containers on Windows are not supported.
For remote Dev Containers the password authentication is not supported.