Docker Registry

Shaep includes a Docker V2-compatible registry. When you push an image, the app catalog is automatically populated — no sync delay.

Image Naming Convention

Images follow this pattern:

{registry_domain}/orgs/{org_id}/{app-slug}:{tag}

For example:

<registry-domain>/orgs/my-org/my-app:v1.0.0

Pushing an Image

1. Log in to the registry

REGISTRY_DOMAIN="<registry-domain>"

docker login "$REGISTRY_DOMAIN"

Use your Shaep credentials or an API token.

2. Tag your image

docker tag my-app:latest "$REGISTRY_DOMAIN/orgs/my-org/my-app:v1.0.0"

3. Push

docker push "$REGISTRY_DOMAIN/orgs/my-org/my-app:v1.0.0"

Automatic Catalog Population

When you push an image:

1. The registry creates a catalog app entry for your organization (if it doesn't exist)
2. The version is upserted with the tag, size, and creation date
3. The app appears immediately in the portal catalog under My Apps

No background sync is needed — the catalog is updated in real time during the push.

Syncing from the Registry

If you need to refresh the catalog entry for an existing app:

1. Go to Apps > Catalog > your app
2. Click Sync from Registry

This re-reads the image metadata from the registry and updates the catalog.

Next Steps

• Browse the catalog to see your pushed images
• Deploy an app from your registry images