Docker
@keeb/dockerv2026.05.31.2
Security Notice
This extension includes AI agent skills that can modify AI assistant behavior. Review the skill files before installing.
01README
Manage Docker Engine and Docker Compose lifecycle on remote hosts over SSH, including install, build, run, inspect, exec, and compose service operations.
02Models
@keeb/docker/enginev2026.02.11.2docker_engine.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| sshHost | string | SSH hostname/IP of the target VM |
| sshUser | string | SSH user (default 'root') |
fn install()
Install Docker Engine on an Alpine VM via SSH
fn build(imageTag: string, contextPath: string, dockerfilePath?: string)
Build a Docker image on the remote host
| Argument | Type | Description |
|---|---|---|
| imageTag | string | Tag for the built image |
| contextPath | string | Build context path on remote host |
| dockerfilePath? | string | Path to Dockerfile (relative to context) |
fn run(containerName: string, imageTag: string, ports?: union, volumes?: union, env?: string, envFile?: string, restart?: string, command?: string)
Run a Docker container (stops existing container with same name first)
| Argument | Type | Description |
|---|---|---|
| containerName | string | Name for the container |
| imageTag | string | Image to run |
| ports? | union | Port mappings (e.g. ['8080:8080']) |
| volumes? | union | Volume mounts |
| env? | string | Environment variables as JSON object string |
| envFile? | string | Path to env file on remote host |
| restart? | string | Restart policy (e.g. 'unless-stopped') |
| command? | string | Command to run in the container |
fn stop(containerName: string)
Stop and remove a Docker container (idempotent)
| Argument | Type | Description |
|---|---|---|
| containerName | string | Name of the container to stop |
fn inspect(containerName: string)
Inspect a Docker container
| Argument | Type | Description |
|---|---|---|
| containerName | string | Name of the container to inspect |
fn exec(containerName: string, command: string, workdir?: string)
Execute a command inside a running Docker container
| Argument | Type | Description |
|---|---|---|
| containerName | string | Name of the container |
| command | string | Command to execute |
| workdir? | string | Working directory inside the container |
Resources
result(infinite)— Docker engine operation result
image(infinite)— Docker image build result
container(infinite)— Docker container state
@keeb/docker/composev2026.05.31.2docker_compose.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| sshHost | string | SSH hostname or IP address |
| sshUser | string | SSH user (default 'root') |
| composePath | string | Path to docker-compose directory on remote host |
| serviceName? | string | Specific service name (optional, operates on all services if omitted) |
| pruneOnUpdate | boolean | Run 'docker image prune -f' after a successful update to reclaim disk space |
| rollbackOnUpdate | boolean | On 'update', capture the running images first and roll back to them if the new deploy fails its health gate |
| updateHealthTimeout | number | Seconds to wait for services to become running/healthy after 'update' before declaring failure (only used when rollbackOnUpdate is true) |
fn start()
Start Docker Compose services
fn stop()
Stop Docker Compose services
fn update()
Pull latest images and restart Docker Compose services; optionally health-gate the new deploy and roll back to the previous images on failure
fn status()
Show Docker Compose service status
fn prune()
Remove dangling Docker images on the remote host to reclaim disk space
Resources
result(infinite)— Docker compose operation result
03Workflows
@keeb/setup-dockerc0240ea9-32d5-424e-b6cf-abfec07c5579
Install Docker Engine on a running VM by name
setupAuth, lookup VM via fleet, install Docker
1.authkeebDev02.auth— Authenticate with Proxmox via keebDev02
2.lookupfleet.lookup— Look up VM to get IP
3.install-dockerdockerEngine.install— Install Docker via SSH
04Skills
docker1 file
05Previous Versions
2026.05.31.1May 31, 2026
Modified 1 models
2026.05.25.1May 25, 2026
2026.04.22.3Apr 22, 2026
2026.04.22.2Apr 22, 2026
2026.03.02.3Mar 3, 2026
2026.03.02.2Mar 3, 2026
2026.03.02.1Mar 3, 2026
2026.02.27.1Feb 27, 2026
06Stats
A
100 / 100
Downloads
44
Archive size
17.5 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
Repository
https://github.com/keeb/swamp-docker07Platforms
08Labels