Docker Run

Run a Docker container from an image or Dockerfile.

Runs a Docker container directly without requiring a GitHub Action wrapper.

The image input uses the docker:// prefix convention (same as GitHub Actions):

Pull from registry (use docker:// prefix): - docker://hello-world - docker://alpine:latest - docker://ghcr.io/owner/image:tag - docker://docker.io/library/nginx

Build from Dockerfile (no prefix): - Dockerfile - ./Dockerfile - ./build/Dockerfile.prod - /absolute/path/to/Dockerfile

Inputs#

Port	Description

Image	Use `docker://` prefix for registry images, or path for Dockerfile.
Registry: `docker://alpine:latest`, `docker://ghcr.io/owner/image`
Dockerfile: `Dockerfile`, `./build/Dockerfile.prod`

Args	Arguments to pass to the container entrypoint.
Entrypoint	Override the image's default entrypoint.
Example: `["/bin/sh", "-c"]`

Working Directory	Working directory inside the container.
For GitHub workflows: defaults to `/github/workspace` (where the repo is mounted).
Otherwise: uses the image's default WORKDIR.

Volumes	Volume mounts in the format `host_path:container_path` or `host_path:container_path:ro` for read-only.
Network	Docker network to connect the container to (e.g., host, bridge, or a custom network name).
Pull Policy	When to pull the image from the registry.
Mount Docker Socket	Mount the host's Docker socket into the container, enabling Docker-in-Docker.
This matches GitHub Actions' default behavior for container actions.
Disable if the container doesn't need Docker access.

Environment Vars	Additional environment variables for the container.
Workflow/job environment variables are automatically included.
Use `KEY=VALUE` format to add or override variables.

Outputs#

Port	Description
Success
Error
Exit Code

ID: core/docker-run@v1