13 releases

0.1.5 Oct 20, 2024
0.1.4 Sep 9, 2024
0.1.2 Aug 31, 2024
0.0.7 Jul 17, 2024
0.0.3 Jun 30, 2024

#464 in Development tools

Download history 168/week @ 2024-07-14 18/week @ 2024-07-21 47/week @ 2024-07-28 4/week @ 2024-08-04 225/week @ 2024-08-11 25/week @ 2024-08-18 124/week @ 2024-08-25 52/week @ 2024-09-01 290/week @ 2024-09-08 51/week @ 2024-09-15 27/week @ 2024-09-22 33/week @ 2024-09-29 21/week @ 2024-10-06 25/week @ 2024-10-13 181/week @ 2024-10-20 33/week @ 2024-10-27

263 downloads per month

Custom license

170KB
4.5K SLoC

Ducker

🐋 A terminal app for managing docker containers, inspired by K9s
Installation · Usage · Configuration

🦀 Written in Rust 🦀

Installation

Cargo

There isn't currently a downloadable build; to install you will need cargo installed:

cargo install --locked ducker

⚠️ Make sure you use --locked: if ducker is installed without --locked it is susceptible to changes in upstream dependencies, which could break the build.

Arch Linux

You can install ducker from the official repositories with using pacman.

pacman -S ducker

Brew

For macOS, you can install ducker using by homebrew.

brew install draftbrew/tap/ducker

Unstable

To install the latest unstable version of Ducker, run the following command:

cargo install --git https://github.com/robertpsoane/ducker

Usage

Ducker is comprised of a set of pages, each of which display specific information about and/or allow interaction with the docker containers and images on the host system.

Top level pages can be navigated to with commands, input via the prompt. Pages can be interacted with using actions; these are input via hotkey inputs.

A legend for common global hotkey inputs is displayed at the bottom of the screen; one for contextual (eg different on each page) hotkey inputs are displayed in the top right.

Commands

The following commands are supported:

Command Aliases Description
images image Open the Images top level page
containers container Open the Containers top level page
volumes volume Open the Volumes top level page
networks network Open the Networks top level page
quit q Close the application

Actions

Global

The following global actions are available on all pages:

Hotkey Action
k/ Navigate up in a list/table
j/ Navigate down in a list/table
Q/q Close the application
: Open the command prompt
G Navigate to the bottom of a list or table
g Navigate to the top of a list or table

Containers

The following actions are available on the Containers page:

Hotkey Action
Ctrl+d Delete the currently selected container
a Exec into the currently selected container (if container is running)*
l View the logs for the currently selected container
r Run the currently selected container
s Stop the currently selected container

*NB: exec currently only supports containers with bash installed. The intention is that this will be updated to provide a user option.

Images

The following actions are available on the Images page:

Hotkey Action
Ctrl+d Delete the currently selected image
d Describe the currently selected image
D Toggle whether or not to show dangling images (off by default)

Volumes

The following actions are available on the Volumes page:

Hotkey Action
Ctrl+d Delete the currently selected volume
d Describe the currently selected volume

Networks

The following actions are available on the Volumes page:

Hotkey Action
Ctrl+d Delete the currently selected volume
d Describe the currently selected volume

⚠️ Network deletion isn't entirely complete: A failed deletion currently results in a yes/no modal telling you that it couldn't be deleted. There is no difference between the yes and no results. This is due to the current modal story and a quick and dirty hack to get them set up. Once a generic modal exists this will be patched up!

Logs

The following actions are available on the Logs page:

Hotkey Action
Esc Return to the containers page

Configuration

Ducker is configured via a yaml file found in the relevant config directory for host platform. On linux this is ~/.config/ducker/config.yaml.

The following table summarises the available config values:

Key Default Description
prompt 🦆 The default prompt to display in the command pane
default_exec /bin/bash The default prompt to display in the command pane. NB - currently uses this for all exec's; it is planned to offer a choice
docker_path unix:///var/run/docker.sock The location of the socket on which the docker daemon is exposed (defaults to npipe:////./pipe/docker_engine on windows)
check_for_update true When true, checks whether there is a newer version on load. If a newer version is found, indicates via note in bottom right.
theme [See below] The colour theme configuration

If a value is unset or if the config file is unfound, Ducker will use the default values. If a value is malformed, Ducker will fail to run.

To create a fully populated default config, run ducker with the -e/--export-default-config flag; this will write the default config to the default location, overwriting any existing config.

Themes

By default, ducker uses the terminal emulator's preset colours. However, it is possible to set a custom colour theme in config. This is set in the theme section of the config file. The following table describes the theme options. The default theme provides the colours provided in the GIF in this README.

Key Default Description
use_theme false When true uses the colour scheme defined in config, when false uses the default terminal colours
title #96E072 The colour used for the Ducker font in the header
help #EE5D43 The colour used in the help prompts in the header
background #23262E The colour used in the background
footer #00E8C6 The colour used for the text in the footer
success #96E072 The colour used for a successful result
error #EE5D43 The colour used for an error result
positive_highlight #96E072 The colour used for highlighting in a happy state
negative_highlight #FF00AA The colour used for highlighting in a sad state

Tmux

Some characters in ducker use italics/boldface. This doesn't work by default when running in tmux. To fix this, add the following to your add to tmux.conf

set -g default-terminal "tmux-256color"
set -as terminal-overrides ',xterm*:sitm=\E[3m'

Dependencies

~36–51MB
~1M SLoC