Skip to content

Tupiet/ulauncher-docker

 
 

Repository files navigation

ulauncher-docker

Ulauncher Extension CircleCI License

Manage your Docker containers from Ulauncher

Demo

Demo

Features

  • Lists all running Docker containers
  • Display container name, image, ip and exposed ports.
  • Allow executing common actions on containers like tailing logs, open a shell, start, stop and restart.
  • And more

Requirements

  • Ulauncher 5
  • Python >= 3
  • Docker daemon running on your machine

This extension also needs docker-py <= 3.7.2 and argparse Python packages.

You can install them in one command using: pip3 install argparse docker==3.7.2

NOTE: Installing the latest docker-py client will break the extension as the client changed the API interface for several methods.

Install

Open ulauncher preferences window -> extensions -> add extension and paste the following url:

https://github.com/brpaz/ulauncher-docker

Usage

On Ulauncher, use "dk" as the default keyword to trigger the extension. By default it will show a list of running containers.

To display all the containers run dk -a.

Other commands:

  • dk info - Show Docker version and provides quick access to Docker Documentation

  • dk utils- Provides access to common commands like "Docker prune"

  • dk -c <containerid|name> - Show container details like name, image and network information and allow to execute quick actions like tailing the container logs or start|stop|restart the container.

Development

git clone https://github.com/brpaz/ulauncher-docker
make link

The make link command will symlink the cloned repo into the appropriate location on the ulauncher extensions folder.

To see your changes, stop ulauncher and run it from the command line with: ulauncher -v.

Contributing

Contributions, issues and Features requests are welcome.

Show your support

Buy Me A Coffee

License

Copywright @ 2019 Bruno Paz

This project is MIT Licensed.

About

Manage your Docker containers from Ulauncher

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 95.3%
  • Makefile 4.7%