Docker Ps
A read-only container listing of a Docker host over SSH, narrow enough to hand to an unattended triage agent. It answers the first question an alert usually raises -- what is running on that host, and which container holds that port -- with name, image, state, status, published ports and creation time per container. It runs docker ps with an explicit, per-field --format template and rebuilds each row from those fields alone, so no environment variable and no label value ever leaves the host: docker inspect returns every container's environment, which is where compose files keep database passwords and API tokens, and docker ps --format '{{json .}}' includes the Labels field. The type has exactly one method and no free-form command or format argument, so a model instance exposes no write verb at all. Host key checking stays on by default.
Global Arguments
| Argument | Type | Description |
|---|---|---|
| sshHost | string | Docker host to reach over SSH (hostname, alias or IP). |
| sshUser? | string | SSH user. Needs permission to run `docker ps`, nothing more. |
| strictHostKeyChecking? | enum | OpenSSH StrictHostKeyChecking. `no` is never the default. |
| knownHostsFile? | string | Optional UserKnownHostsFile override. |
| Argument | Type | Description |
|---|---|---|
| all? | boolean | Include stopped containers (`docker ps -a`). Defaults to true: a crashed container is usually the one you are looking for. |
Resources
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Docs keep secrets in a vault1/1earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License2/2earned
- Verified public repository2/2earned
Spawns a subprocess with Deno.Command().
- models/docker_ps.ts:274 — no reason given