Skip to content

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:

CommandAliasesDescription
imagesimageOpen the Images top level page
containerscontainerOpen the Containers top level page
volumesvolumeOpen the Volumes top level page
networksnetworkOpen the Networks top level page
helphOpen the Help page
quitqClose the application

Actions

Global

The following global actions are available on all pages:

HotkeyAction
k/Navigate up in a list/table
j/Navigate down in a list/table
Q/qClose the application
:Open the command prompt
GNavigate to the bottom of a list or table
gNavigate to the top of a list or table

Containers

The following actions are available on the Containers page:

HotkeyAction
Ctrl+dDelete the currently selected container
aExec into the currently selected container (if container is running)*
lView the logs for the currently selected container
rRun the currently selected container
sStop 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:

HotkeyAction
Ctrl+dDelete the currently selected image
Alt+dToggle dangling images
dDescribe the currently selected image

Volumes

The following actions are available on the Volumes page:

HotkeyAction
Ctrl+dDelete the currently selected volume
Alt+dToggle dangling volumes
dDescribe the currently selected volume

Networks

The following actions are available on the Networks page:

HotkeyAction
Ctrl+dDelete the currently selected network
dDescribe the currently selected network

⚠️ 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:

HotkeyAction
EscReturn to the containers page

Sorting Hotkeys

Tip: Use Shift + the indicated key to sort columns. Pressing the same sorting key again will sort the same column in the opposite order (toggle ascending/descending). See the table below for each page's sort options.

Containers

HotkeyAction
Shift+NSort by name
Shift+ISort by image
Shift+SSort by status
Shift+CSort by created
Shift+PSort by ports

Images

HotkeyAction
Shift+NSort by name
Shift+CSort by created
Shift+TSort by tag
Shift+SSort by size

Networks

HotkeyAction
Shift+NSort by name
Shift+CSort by created
Shift+SSort by scope
Shift+DSort by driver

Volumes

HotkeyAction
Shift+NSort by name
Shift+CSort by created
Shift+DSort by driver
Shift+MSort by mountpoint

🦀 It's written in Rust so it must be good! 🦀