modal-projects/runner-modal/runner-modal-images

Customizing runner-modal Job images

Jobs load the published Named Image {name}-job. Runner.create(image=) is the webhook Function image only.

Rules

• Default CPU: Runner.create publishes default_image() as {name}-job.
• GPU: separate App, gpu= on Runner.create. See examples/gpu/app.py.
• Docker-in-CI: experimental_options={"vm_runtime": True} (no GPU).
• Custom toolchain: build with Runner.install_actions_runner, then

.publish(f"{name}-job") after Runner.create. Last publish wins. Keep JOB_DEPS, add_local_python_source("runner_modal", copy=True), and RUNNER_ALLOW_RUNASROOT=1. No Path / add_local_dir.

• cache=True mounts {name}-cache at /cache for every Job in that

pool. Same-pool only. Default is cache=False.

Point tools at /cache in the workflow when you enable it.