Skip to content

Support custom container images for containerized runners #44

Description

@nicktallen

Problem

Container isolation mode currently uses a default Linux image. Users may need custom images with specific tools, libraries, or configurations pre-installed.

Proposed Solution

Allow users to specify a custom OCI container image when creating a runner with container isolation:

mac-runner add owner/repo --isolation container --image ghcr.io/myorg/runner-image:latest

Acceptance Criteria

  • Accept --image flag in CLI for container isolation runners
  • Image picker/text field in GUI Add Runner form
  • Pull image from OCI registries (Docker Hub, GHCR, etc.)
  • Cache pulled images locally
  • Default image still works when no custom image specified
  • Document supported image requirements (must have runner binary, etc.)

Notes

Listed in README under "Planned Features." Filing to track formally. Requires container isolation (macOS 26+, Apple Silicon).

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestpriority:lowBacklog — future consideration

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions