mise-en-place

Appearance

mise oci run ​

[experimental] Build an OCI image from the current mise.toml and run a command in it

Equivalent to mise oci build followed by docker run / podman run. The built image is loaded into the local container engine (podman is preferred; docker works via skopeo) and the given command is executed inside it with stdin/stdout/stderr inherited.

Requires mise settings experimental=true (or MISE_EXPERIMENTAL=1) and one of: podman, docker+skopeo.

Arguments ​

[-- CMD]… ​

Command and arguments to run inside the container (after --)

Flags ​

--engine <ENGINE> ​

Container engine to use (auto, podman, or docker)

Choices:

  • auto
  • podman
  • docker

Default: auto

--from <FROM> ​

Base image reference for the build (ignored with --image-dir)

--image-dir <IMAGE_DIR> ​

Use an already-built OCI image layout instead of building fresh

--keep ​

Keep the loaded image in the engine's storage after the run

By default, both the container (--rm) and the loaded image are removed when the command exits, so repeated mise oci run calls don't accumulate images in podman / docker storage. Pass --keep to retain the image under the tag mise used (mise-oci:run-* for docker; the pulled image ID for podman).

--mount-point <MOUNT_POINT> ​

Override in-image mount point (ignored with --image-dir)

--no-mise ​

Don't embed the mise binary (ignored with --image-dir)

--volume… <HOST:CONTAINER> ​

Bind-mount a host path (repeatable, HOST:CONTAINER[:MODE])

Note: unlike docker run -v, there's no -v short flag here because mise reserves -v for --verbose. Use --volume or --mount.

-e --env… <KEY=VAL> ​

Set environment variable in the container (repeatable, KEY=VAL)

-i --interactive ​

Run interactively (pass -i to the engine)

-t --tty ​

Allocate a TTY (pass -t to the engine)

-w --workdir <WORKDIR> ​

Working directory inside the container

Examples:

Build the current mise.toml and drop into bash:
$ mise oci run -it -- bash

Run a one-shot command with env + volume (note: `-v` is reserved
for --verbose, so use `--volume`):
$ mise oci run -e DEBUG=1 --volume $PWD:/work -w /work -- npm test

Re-use a previously built layout (skip the build step):
$ mise oci build -o ./img && mise oci run --image-dir ./img -- node -e 'console.log(process.version)'

Engines:

Prefers podman (loads OCI layouts natively). Falls back to
docker + skopeo. Pass --engine podman or --engine docker to override.
MIT LicenseCopyright © 2026en.dev