Prerequisites and limitations

Prerequisites

• You have a project that contains the .devcontainer folder with the devcontainer.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, and customizations.

  • 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.