/gnome-shell-extension-containers

containers is a gnome-shell extension to manage linux container, run by podman

Primary LanguageJavaScriptApache License 2.0Apache-2.0

Project Icon

GNOME Shell Extension: Containers

Manage Linux containers seamlessly using Podman within the GNOME Shell.

GitHub stars
GitHub issues

Features ✨

This extension provides a convenient GNOME Shell menu to manage your Podman containers. Supported actions include:

  • Start: Initialize containers. πŸš€
  • Stop: Terminate running containers. πŸ›‘
  • Remove: Delete containers. πŸ—‘οΈ
  • Pause: Suspend container processes. ⏸️
  • Restart: Reboot containers. πŸ”„
  • Top Resources: Display resource usage stats. πŸ“Š
  • Shell Access: Open a terminal shell in the container. πŸ”§
  • Live Stats: View real-time statistics in a new terminal. πŸ“ˆ
  • Logs Monitoring: Follow logs in a new terminal session. πŸ“‹
  • Inspect Info: View and copy detailed inspection information. πŸ”

Installation πŸ› οΈ

From GNOME Extensions Page 🌐

You can install this extension directly from the GNOME Extensions page.

From Source πŸ“‚

  1. Clone the repository:

    git clone https://github.com/rgolangh/gnome-shell-extension-containers
    cd gnome-shell-extension-containers
  2. Build and install:

make all
  1. Enable the extension:
make enable

Alternatively, enable it via Extensions -> Toggle 'Containers'.

Development / Contributing 🀝

To contribute to the development of this extension:

Clone the repository and make your changes. Debugging: Spin up an inline GNOME Shell session in a dedicated window:

make debug

Contributions are welcome! Please ensure your code follows the project’s style guidelines and is thoroughly tested before submitting a pull request.

Screenshot πŸ“Έ

Project Icon

License πŸ“œ

Apache-2.0 License