Skip to main content
Set the default devcontainer image for repositories without a devcontainer configuration. Useful when:
  • Standardizing base tooling across all environments
  • Pre-installing company-specific tools or certificates
  • Using internal images from a private registry

Configuration

Enter a container image reference (e.g., mcr.microsoft.com/devcontainers/base:ubuntu-24.04). If empty, uses system default.
Using private images? Set up container registry credentials first.
Default environment image

When this image is used

ScenarioImage used
Repository has .devcontainer/devcontainer.jsonRepository’s configured image
Repository has no devcontainer configOrganization default image
Blank environment (no repository)Organization default image
Repository devcontainer configurations always take precedence over the organization default.