https://github.com/RedSoftwareSystems/easy_docker_containers
An extension for managing docker containers
https://github.com/RedSoftwareSystems/easy_docker_containers
Last synced: 10 months ago
JSON representation
An extension for managing docker containers
- Host: GitHub
- URL: https://github.com/RedSoftwareSystems/easy_docker_containers
- Owner: RedSoftwareSystems
- Fork: true (gpouilloux/gnome-shell-extension-docker)
- Created: 2019-04-06T04:55:22.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2025-04-02T14:47:06.000Z (10 months ago)
- Last Synced: 2025-04-11T23:43:54.885Z (10 months ago)
- Language: JavaScript
- Size: 4.19 MB
- Stars: 70
- Watchers: 3
- Forks: 23
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# 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.)_
## Prerequisite[^1]
1. Properly installed and already running Docker service.
2. Corresponding Linux user in `docker` Linux group for manage '_Docker_' without `sudo` permission.
[^1]: independently from the extension itself
## Installation
- You can simply install this extension from [it's extensions.gnome.org page](https://extensions.gnome.org/extension/2224/easy-docker-containers)[^2],
[^2]: You could update it from here in the future.
- **or** you can pull it from it's GitHub source code repository directly into it's required GNOME Shell directory [^3]
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)_.
[^3]: DO not change this directory name!
## Contributors
- [kiuma](https://github.com/RedSoftwareSystems)
- [Tamas-Toth-ebola](https://github.com/Tamas-Toth-ebola)
- [jacobfogg](https://github.com/jacobfogg)
- [albeto001](https://github.com/albeto001)
- [pierreavizou] (https://github.com/pierreavizou)
- [hhoao] (https://github.com/hhoao)
## Credits
This extension is a fork of [gpouilloux's](https://github.com/gpouilloux) great original [Gnome Shell extension for Docker](https://github.com/gpouilloux/gnome-shell-extension-docker) work.
## License
[GNU - General Public License v3+](https://www.gnu.org/licenses/gpl-3.0.en.html)