> ## Documentation Index
> Fetch the complete documentation index at: https://allhandsai-docs-provider-connections.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Single Image via Admin Console

> Configure a single custom sandbox image for the whole installation through the Replicated Admin Console.

<Warning>
  **This approach is deprecated.** It configures one image for the entire
  installation and does not support per-user image selection or multiple
  simultaneous environments.

  New installations should use
  [Configuring Custom Sandbox Images](/enterprise/custom-sandbox-images/multiple-images-warm-pools)
  instead. This page is retained for installations that have not yet migrated.
  Both approaches coexist — you can adopt warm runtime pools without removing
  this setting.
</Warning>

Once your image is built and pushed to a registry, point the Replicated Admin
Console at it.

1. Open the **Admin Console** at `https://admin.<your-base-domain>:30000`.
2. Navigate to **Config** and find the **Sandbox Configuration** section.
3. Set the following fields:

| Field | Value |
| - | - |
| **Use a Custom Sandbox Image** | Enabled |
| **Sandbox Image Repository** | Your image repository (e.g. `ghcr.io/your-org/openhands-custom-image`) |
| **Sandbox Image Tag** | Your image tag (e.g. `v1.2.0`) |
| **Registry Server** | If your registry requires authentication |
| **Registry Username** | If your registry requires authentication |
| **Registry Password or Credentials** | If your registry requires authentication |

4. Click **Save config** and then **Deploy** to apply the change.

This single image becomes both the default for new conversations and the image
kept ready in the installer-managed warm pool.

<Note>
  This setting applies to the **sandbox / agent-server image** only — the
  image that runs inside each agent's isolated workspace. It does not replace
  the other OpenHands service images.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.