Skip to main content
← back to extensions

@keeb/docker

v2026.04.22.3

Manage Docker Engine and Docker Compose lifecycle on remote hosts over SSH, including install, build, run, inspect, exec, and compose service operations.

Repository

https://github.com/keeb/swamp-docker

Platforms

linux-x86_64linux-aarch64darwin-x86_64darwin-aarch64

Labels

dockercontainersinfrastructure

Quality score

How well-documented and verifiable this extension is.

100%

Grade A

  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types1/1earned
  • Has description1/1earned
  • At least one platform tag (or universal)1/1earned
  • Two or more platform tags (or universal)1/1earned
  • License declared1/1earned
  • Verified public repository2/2earned

Install

$ swamp extension pull @keeb/docker

Security Notice

This extension includes AI agent skills that can modify AI assistant behavior. Review the skill files before installing.

@keeb/docker/enginev2026.02.11.2docker_engine.ts

Global Arguments

ArgumentTypeDescription
sshHoststringSSH hostname/IP of the target VM
sshUserstringSSH user (default 'root')
installInstall Docker Engine on an Alpine VM via SSH
buildBuild a Docker image on the remote host
ArgumentTypeDescription
imageTagstringTag for the built image
contextPathstringBuild context path on remote host
dockerfilePath?stringPath to Dockerfile (relative to context)
runRun a Docker container (stops existing container with same name first)
ArgumentTypeDescription
containerNamestringName for the container
imageTagstringImage to run
ports?unionPort mappings (e.g. ['8080:8080'])
volumes?unionVolume mounts
env?stringEnvironment variables as JSON object string
envFile?stringPath to env file on remote host
restart?stringRestart policy (e.g. 'unless-stopped')
command?stringCommand to run in the container
stopStop and remove a Docker container (idempotent)
ArgumentTypeDescription
containerNamestringName of the container to stop
inspectInspect a Docker container
ArgumentTypeDescription
containerNamestringName of the container to inspect
execExecute a command inside a running Docker container
ArgumentTypeDescription
containerNamestringName of the container
commandstringCommand to execute
workdir?stringWorking 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.02.11.1docker_compose.ts

Global Arguments

ArgumentTypeDescription
sshHoststringSSH hostname or IP address
sshUserstringSSH user (default 'root')
composePathstringPath to docker-compose directory on remote host
serviceName?stringSpecific service name (optional, operates on all services if omitted)
startStart Docker Compose services
stopStop Docker Compose services
updatePull latest images and restart Docker Compose services
statusShow Docker Compose service status

Resources

result(infinite)— Docker compose operation result

@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

docker1 file