/docker.el

Manage docker images & containers from Emacs.

Primary LanguageEmacs Lisp

docker.el

THIS PACKAGE IS USABLE BUT UNDER HEAVY DEVELOPMENT

Installation

The recommended way to install docker.el is through MELPA.

Quickstart

Use M-x docker-images or M-x docker-containers, then mark/unmark items using the following keybindings:

  • m: mark
  • u: unmark
  • t: toggle marks
  • U: unmark all

Press ? to known about available keybindings in order to run actions on these items.

You can also call the API directly.

Screenshots

images

docker.el screenshot

Keymaps

docker-global-mode

Running M-x docker-global-mode creates keybindings to the various docker api. The keymap prefix is C-c d by default and can be changed with M-x customize-variable docker-keymap-prefix.

command keymap description
docker-containers C-c d c c or C-c d C list containers
docker-rm C-c d c d delete container
docker-stop C-c d c o stop container
docker-pause C-c d c p pause container
docker-restart C-c d c r restart container
docker-start C-c d c s start container
docker-unpause C-c d c u unpause container
docker-images C-c d i i or C-c d I list images
docker-rmi C-c d i d delete image
docker-pull C-c d i f pull image
docker-push C-c d i p push image
docker-run C-c d i r run image
dockerfile-build-buffer C-c d B Build Dockerfile

docker-images

M-x docker-images lists the docker images. After having selected some images, you can do the following actions:

  • F: pull
  • P: push
  • D: rmi
  • R: run

docker-containers

Running M-x docker-containers lists the docker containers. After having selected some containers, you can do the following actions:

  • S: start
  • O: stop
  • P: pause
  • U: unpause
  • R: restart
  • D: rm

API

docker-rm

Deletes a container.

docker-stop

Stops a container.

docker-pause

Pauses a container.

docker-restart

Restarts a container.

docker-start

Starts a container.

docker-unpause

Unpause a container.

docker-rmi

Deletes an image.

docker-pull

Pull an image.

docker-push

Push an image.

docker-run

Run an image.

dockerfile-build-buffer

See docker-file-mode for more information,

Philosophy

This package is inspired by packages like:

  • dired / ibuffer for selecting images / containers to operate on.
  • magit for the various actions popups.
  • projectile for the keymap.

Contributions welcome!

Either as suggestions or as pull requests by opening tickets on the issue tracker.