Recipe

docker-model-runner

A model served by the host's own Docker Model Runner, for local development via Docker Compose. The Recipe writes the model into the compose file's top-level `models` element under the component's own name, with its context size and runtime flags, and Compose pulls and configures it there when the stack starts. Beside it the Recipe adds one service under the same name, granted the model. Compose leaves out a model no service is granted, so without it a plain `docker compose up` would pull nothing. The service runs a minimal image that exits at once; Compose has already pulled and configured the model before it starts any container. provides.endpoint is the address containers reach the host's runner at, infra.endpoint, which defaults to Docker Desktop's http://model-runner.docker.internal/engines/v1; on Docker Engine a Release sets it to the address the host's runner answers containers at. Host, port and protocol are read from it. The settings that size or place an in-cluster server — port, engine_version, replicas, compute, gpu and model_cache — are refused here by name.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:fa85e2b6d40d8e8d4a56c8f3bf7642cba811faa20b512d93e2400a3c3a712d2c
Published
2026-11-10T10:18:54Z
Signing identity
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officialapplication/vnd.dev.sigstore.bundle.v0.3+json

    https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

    sha256:7c5bc54d6a263f548f70e89d8d4de42b4e1d1c34c05b1b18b91f79117f59f220

Reference at this version

oci://hub.aggrega.ai/recipe/compose/docker-model-runner:1.0.0
Target
—
Implements
core/ai-model/docker-model-runner:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
host{{ .locals.hostname }}
port{{ .locals.port }}
endpoint{{ .locals.endpoint }}
model{{ .values.model }}
protocol{{ .locals.scheme }}

Workload

No workload template declared.

Locals

NameTemplate
endpoint{{ optional .infra "endpoint" "http://model-runner.docker.internal/engines/v1" }}
scheme{{ (urlParse .locals.endpoint).scheme }}
hostname{{ (urlParse .locals.endpoint).hostname }}
port{{ $u := urlParse .locals.endpoint }}{{ $p := regexFind ":[0-9]+
quot; $u.host | trimPrefix ":" }}{{ if $p }}{{ $p }}{{ else if eq $u.scheme "http" }}80{{ else }}443{{ end }}

Values mapping

No values mapping declared.

Relationships

Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.

Uses

Used by

Nothing in the catalog depends on this entity.

Recipe concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy