Skip to content
HyperOptimizerHyperOptimizerHyperOptimizer Docs

Publish an image

HyperOptimizer runs trials from images in your organization’s Images registry. Build locally (or in CI), then tag and push to the host and project shown in the dashboard.

Before you start

Section titled “Before you start”

Open Dashboard → Images. When the registry is ready, you will see:

  • Registry host and project name
  • Robot username and password (copy the login command from the UI)
  • Storage usage against your plan quota

Docker CLI

Section titled “Docker CLI”

  1. Log in using the command from Dashboard → Images (username and password are filled in for you).

    Terminal window
    docker login <registry-host>

  2. Tag your local image for the org project:

    Terminal window
    docker tag <local-image> <registry-host>/<project>/<repo>:<tag>

    Example shape: registry.example.com/org_abc123/my-app:v1.

  3. Push the image:

    Terminal window
    docker push <registry-host>/<project>/<repo>:<tag>

  4. Refresh the Images page so the new repository and tag appear, then pick them when you create an experiment.

GitHub Actions

Section titled “GitHub Actions”

Store the robot credentials as repository secrets (not in the workflow file):

Secret Value
REGISTRY_USERNAME Robot account from Dashboard → Images
REGISTRY_PASSWORD Robot secret from Dashboard → Images

Example workflow (adjust repo name and default branch as needed):

name: Publish container image


on:
  push:
    branches: [main]
  workflow_dispatch:


permissions:
  contents: read


env:
  REGISTRY_HOST: registry.example.com
  IMAGE_NAME: registry.example.com/org_abc123/my-app


jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - name: Check out repository
        uses: actions/checkout@v6


      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v4


      - name: Log in to registry
        uses: docker/login-action@v4
        with:
          registry: ${{ env.REGISTRY_HOST }}
          username: ${{ secrets.REGISTRY_USERNAME }}
          password: ${{ secrets.REGISTRY_PASSWORD }}


      - name: Build and push
        uses: docker/build-push-action@v7
        with:
          context: .
          push: true
          tags: ${{ env.IMAGE_NAME }}:${{ github.sha }}

Replace REGISTRY_HOST and IMAGE_NAME with the values from your Images page. Successful runs publish an image tagged with the commit SHA.

Storage quotas

Section titled “Storage quotas”
Plan Registry storage
Free 1 GB
Starter 5 GB
Pro 20 GB
Enterprise 100 GB

Delete unused tags from the Images page if you approach the quota. See Plans and credits for the full plan table.

Next steps

Section titled “Next steps”