> ## Documentation Index
> Fetch the complete documentation index at: https://ona.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Default image

> Set the default devcontainer image for repositories without configuration.

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.

<Note>Using private images? [Set up container registry credentials](/ona/configuration/secrets/container-registry-secret) first.</Note>

<img src="https://mintcdn.com/gitpod-13c83c2b/p3fxpb4g8LzRcRvi/images/docs/flex/organizations/default-image.png?fit=max&auto=format&n=p3fxpb4g8LzRcRvi&q=85&s=2acad3b0cfaf4e2b3ea3a5efe677b39f" alt="Default environment image" width="1539" height="740" data-path="images/docs/flex/organizations/default-image.png" />

## When this image is used

| Scenario                                         | Image used                     |
| ------------------------------------------------ | ------------------------------ |
| Repository has `.devcontainer/devcontainer.json` | Repository's configured image  |
| Repository has no devcontainer config            | **Organization default image** |
| Blank environment (no repository)                | **Organization default image** |

Repository devcontainer configurations always take precedence over the organization default.