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:2.0.4-noble). If empty, uses system default.
Using private images? Set up container registry credentials first.
Default environment image

​
When this image is used

Repository devcontainer configurations always take precedence over the organization default. On eligible Enterprise AWS runners, Ona also uses the default image to maintain automatic base snapshots. Base snapshots cache the image and shared startup assets without storing project or user data.

​
Reset cached image data

This feature is in preview and available only to selected organizations.
Enterprise organization admins can reset cached image data from the Reset cached image data action below the default image policy. Use this when environments may be using stale or incorrect cached image data.
  1. Select Reset cached image data.
  2. Review the startup impact, then select Reset cache.
Ona clears the cached image data and rebuilds it automatically. Until the new cache is ready, environments can take longer to start because they pull the default image instead of restoring cached image data.