Skip to content

feat: KURTOSIS_IMAGE_ORG env var to override the org prefix of Kurtosis' own images#3157

Open
qu0b wants to merge 2 commits into
kurtosis-tech:mainfrom
qu0b:qu0b/image-org-override
Open

feat: KURTOSIS_IMAGE_ORG env var to override the org prefix of Kurtosis' own images#3157
qu0b wants to merge 2 commits into
kurtosis-tech:mainfrom
qu0b:qu0b/image-org-override

Conversation

@qu0b

@qu0b qu0b commented Jun 15, 2026

Copy link
Copy Markdown
Collaborator

What

Add a small image_org helper and a KURTOSIS_IMAGE_ORG environment variable that overrides the org/registry prefix used for Kurtosis' own images — engine, core (API container), and files-artifacts-expander. It defaults to kurtosistech, so behavior is unchanged unless the var is set.

Why

Today these prefixes are hardcoded (kurtosistech/engine, kurtosistech/core, kurtosistech/files-artifacts-expander) — each with a // TODO This should come from the same logic that builds the server image note. Operators who mirror Kurtosis images into a private registry, or run images built under a different org, currently can't redirect them without patching the source.

How

  • New container-engine-lib/lib/image_org with Get() (returns $KURTOSIS_IMAGE_ORG or the kurtosistech default) and the exported EnvVarName.
  • The engine and API-container launchers build their child image refs as image_org.Get() + "/" + <name> + ":" + version instead of the hardcoded literal.
  • The engine launcher propagates KURTOSIS_IMAGE_ORG into the engine's env, and the API-container launcher propagates it into each API container's env — so the override cascades to images launched at every level.

Default path is a no-op; only set the var to redirect.

Adds an image_org helper + KURTOSIS_IMAGE_ORG env var that overrides the
org/registry prefix of Kurtosis' own images (engine, core,
files-artifacts-expander), defaulting to kurtosistech. The engine propagates the
value to each API container so the override applies at every launch level. This
lets operators run Kurtosis from images mirrored to / built under a private
registry without code changes.
@qu0b qu0b force-pushed the qu0b/image-org-override branch from 3530654 to 5159721 Compare June 15, 2026 18:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant