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

# Container Registry

> Almacene imágenes privadas y artefactos OCI, controle el acceso y automatice la limpieza.

Container Registry almacena imágenes y artefactos OCI en su cuenta y región. Envíe y descargue con Docker, Podman u otro cliente OCI. Use la API REST para administrar repositorios, políticas, cifrado y reglas de caché.

São Paulo usa `cr.sa-saopaulo-1.basaltic.cloud` para Docker y clientes OCI. Las referencias incluyen el identificador de la cuenta: `cr.sa-saopaulo-1.basaltic.cloud/my-account/api:v1`. La API de administración usa `registry.sa-saopaulo-1.basaltic.sh`. Use la `uri` devuelta por el repositorio en lugar de construirla manualmente.

<span id="repositories-images-and-tags" />

## Repositorios, imágenes y etiquetas

Un repositorio tiene nombre inmutable, protección opcional contra eliminación y etiquetas mutables o inmutables. El digest identifica los bytes exactos del manifiesto. Una etiqueta apunta a un manifiesto y puede cambiar, salvo cuando lo impide la inmutabilidad. Los manifiestos multiplataforma, firmas y otros artefactos OCI siguen el mismo modelo.

Eliminar una etiqueta borra ese puntero. Eliminar un digest borra el manifiesto y todas las etiquetas asociadas. Las capas se deduplican entre repositorios de la misma cuenta; eliminar una imagen no libera inmediatamente todos los bytes. La limpieza elimina capas sin referencias.

<span id="authentication" />

## Autenticación

La API REST en `/v1` usa un bearer token de la plataforma y `X-Account-Id`, según [Autenticación](/es/authentication). Los clientes de contenedores usan `/v2` y una credencial temporal separada obtenida en `POST /v1/authorization-token`. Esa credencial no accede a la API de administración. IAM y las políticas de recurso determinan el acceso por repositorio.

<CardGroup cols={2}>
  <Card title="Crear un repositorio" href="/es/registry/create-repository">Choose a name, tag settings, and deletion protection.</Card>
  <Card title="Enviar y descargar imágenes" href="/es/registry/images">Authenticate a container client and deploy by digest.</Card>
  <Card title="Políticas de ciclo de vida" href="/es/registry/lifecycle">Preview cleanup rules before installing them.</Card>
  <Card title="Cifrado" href="/es/registry/encryption">Choose platform encryption or a customer-managed KMS key.</Card>
  <Card title="Caché de imágenes" href="/es/registry/pull-through-cache">Cache upstream images under an account-owned prefix.</Card>
  <Card title="Permisos" href="/es/registry/permissions">Separate image consumers, publishers, and administrators.</Card>
</CardGroup>


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