Files
community-plugins/mini-docker

Mini Docker

Mini Docker is a Noctalia v5 plugin for managing Docker from the shell. The bar widget shows Docker availability and the running-container count. Its management panel can start, stop, restart, and remove containers; run and remove images; and inspect or remove volumes and networks.

This Luau implementation migrates the Noctalia v4 Mini Docker plugin originally written by MannuVilasara.

Requirements

  • Noctalia 5.0.0 or newer
  • Docker CLI and a reachable Docker daemon
  • Permission for the current user to access Docker

Usage

Enable 8bury/mini-docker, then add its mini-docker widget to a bar. Click the widget to open the management panel. Right-click it to refresh Docker state immediately.

The panel has four tabs:

  • Containers: start, stop, restart, or remove a selected container
  • Images: run an image with optional name, network, port, and environment variables, or remove an unused image
  • Volumes: inspect and remove volumes
  • Networks: inspect and remove non-default networks

Settings control the refresh interval, default run network, running count, icon color, and status indicator.

Security

Mini Docker invokes only the local docker CLI. Subprocess arguments are shell-quoted, and user-entered container names, ports, and environment-variable keys are validated before execution.

License

MIT. Attribution to the original v4 author is retained above.