Easy Docker Containers

A GNOME Shell extension (GNOME Panel applet) to be able to generally control your available Docker containers.

Screenshot

Usage

The following actions are available from the GNOME Panel menu per Docker container:

• Start (compose) (Will start the services of the related compose project when available.)
• Stop (compose) (Will stop the services of the related compose project when available.)
• Pause (compose) (Will pause the services of the related compose project when available.)
• Restart (compose) (Will restart the services of the related compose project when available.)
• Start (Will start the container.)
• Stop (Will stop the container.)
• Pause (Will pause the container.)
• Restart (Will restart the container.)
• Exec (Will login to the running container interactively through your default terminal application.)
• Logs (Will start the running container's Docker logs in your default terminal application.)

Devcontainer support

When a stopped container was created from a Dev Container workspace (i.e. the workspace folder contains a .devcontainer/devcontainer.json), the extension shows additional information and actions:

• The devcontainer name (from devcontainer.json) is displayed as a subtitle under the container entry.
• The workspace folder path is shown as a clickable item — clicking it opens a terminal at that folder.
• Start (Runs devcontainer up --workspace-folder <path> to start the container and apply all lifecycle commands.)
• Recreate and start (Runs devcontainer up --remove-existing-container --workspace-folder <path> to destroy the existing container and create a fresh one from the image.)

For running devcontainers, an additional action is available:

• Open in IDE (Runs the configured IDE command to attach your editor to the running container — see IDE command below.)

Note: these actions require the devcontainer CLI to be installed and reachable on PATH (including version-manager-managed paths such as NVM or pyenv).

Open in IDE command

Configure a shell command in the extension preferences (Devcontainer → Open in IDE command) to attach your editor to a devcontainer. The command is triggered in two situations:

• Clicking Open in IDE on any running devcontainer.
• Automatically after a successful Recreate and start (since recreation replaces the container ID, causing IDEs to lose their connection).

Use %workspaceFolder% as a placeholder for the workspace folder path. Examples:

IDE	Command
VS Code / Cursor	code --folder-uri "vscode-remote://dev-container+$(printf '%s' '%workspaceFolder%' | od -An -tx1 | tr -dc '[:xdigit:]')/workspaceFolder"
Zed	zed %workspaceFolder% (Zed detects the devcontainer and prompts to reopen)
IntelliJ / JetBrains	No CLI hook available — reconnect manually from inside the IDE.

Leave the field empty to skip this step entirely.

Prerequisite¹

1. Properly installed and already running Docker service.
2. Corresponding Linux user in docker Linux group for manage 'Docker' without sudo permission.
3. (Devcontainer features only) devcontainer CLI installed and on PATH.

Installation

• You can simply install this extension from it's extensions.gnome.org page²,

• or you can pull it from it's GitHub source code repository directly into it's required GNOME Shell directory ³

  1. git clone https://github.com/RedSoftwareSystems/easy_docker_containers.git ~/.local/share/gnome-shell/extensions/easy_docker_containers@red.software.systems
  2. Restart your shell: [ALT] + [F2] + 'r' + [Enter] (or logout and login again)
  3. Enable the extension manually with 'GNOME Extensions' application (or with 'GNOME Tweaks' application).

Contributors

• kiuma
• Tamas-Toth-ebola
• jacobfogg
• albeto001
• [pierreavizou] (https://github.com/pierreavizou)
• [hhoao] (https://github.com/hhoao)

Credits

This extension is a fork of gpouilloux's great original Gnome Shell extension for Docker work.

License

GNU - General Public License v3+

Footnotes

1. independently from the extension itself ↩

2. You could update it from here in the future. ↩

3. DO not change this directory name! ↩