Need help with docker.el?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

552 Stars 61 Forks 332 Commits 18 Opened issues


Manage docker from Emacs.

Services available


Need anything else?

Contributors list



Emacs integration for Docker!

Supports docker containers, images, volumes, networks and docker-compose.


List images

Images list

Image run

Image run


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

Here is a example use-package configuration:

(use-package docker
  :ensure t
  :bind ("C-c d" . docker))


Use M-x docker, select a resource then then mark or unmark items using the following keybindings (for more marking possibilities, check out

| Binding | Description | |--------------------|----------------------| | ? | List actions | | l | Configure listing | | m | Mark item | | u | Unmark item | | t | Toggle marks | | U | Unmark all | | s | Sort | | * r | Mark items by regexp | | < | Shrink column | | > | Enlarge column | | C-c C-e | Export to csv |

Then select an action and follow the instructions.

Supported commands

  • docker container: attach, cp, diff, inspect, kill, logs, pause, rename, restart, rm, start, stop, unpause
  • docker image: inspect, pull, push, rm, run, tag
  • docker network: rm
  • docker volume: rm
  • docker-compose: build, config, create, down, exec, logs, pull, push, remove, restart, run, start, stop, up

You can also enter

or open a file inside a container or volume.


Thanks to transient, all the transients arguments can be set temporarily or permanently. See for more information.

There are also hidden items (e.g on

M-x docker
where you could specify the host or TLS settings), see for more information.

Here is a list of other customizations you can set:

| Variable | Description | Default | |-----------------------------------|---------------------------------------|----------------------| | docker-command | The binary to use |

| | docker-container-columns | Columns definition for containers |
| | docker-container-default-sort-key | Sort key for containers |
| | docker-container-shell-file-name | Shell to use when entering containers |
| | docker-image-columns | Columns definition for images | Too complex to show | | docker-image-default-sort-key | Sort key for images |
| | docker-network-columns | Columns definition for networks | Too complex to show | | docker-network-default-sort-key | Sort key for networks |
| | docker-run-as-root | Run docker as root |
| | docker-run-default-args | Base arguments to use for docker run |
("-i" "-t" "--rm")
| | docker-volume-columns | Columns definition for volumes | Too complex to show | | docker-volume-default-sort-key | Sort key for volumes |

Changing the Default Arguments for
docker run

You can match on the repository name for an image to customize the initial infix arguments via

   `("^postgres" ("-e POSTGRES_PASSWORD=postgres" . ,docker-run-default-args)))

So when

docker run
is called on an image whose repository name matches the regular expression
, the option
will appear as set along with the defaults specified by


They are very welcome, either as suggestions or as pull requests by opening tickets on the issue tracker.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.