compose_pull
Pre-fetch Docker Compose service images before startup to stage them for outages, refresh caches, or verify accessibility without launching containers.
Instructions
Pre-fetch images for a compose project's services without starting them.
Use this to stage images before an outage window, to refresh cached images before
compose_up, or to verify images are accessible without starting containers. For
registry-authenticated pulls ensure the daemon is logged in first with system_login.
compose_up --pull always does the same as part of startup; use this tool when you
want to separate the pull step.
args:
project_dir - Dir with the compose file (default: server cwd; copied to the target host if no local plugin)
files - Explicit compose file paths (repeatable, -f; overrides auto-discovery)
project_name - Override the compose project name
services - Pull only these services; omit to pull all
ignore_pull_failures - Continue if an individual image pull fails
timeout_seconds - Subprocess timeout (default 1800s for large image pulls)
returns: dict - {"returncode": int, "stdout": str, "stderr": str, "truncated": bool}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| files | No | ||
| services | No | ||
| project_dir | No | ||
| project_name | No | ||
| timeout_seconds | No | ||
| ignore_pull_failures | No |