Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/robertpsoane/ducker
A slightly quackers Docker TUI based on k9s ๐ฆ
https://github.com/robertpsoane/ducker
developer-tools docker ratatui-rs
Last synced: about 2 months ago
JSON representation
A slightly quackers Docker TUI based on k9s ๐ฆ
- Host: GitHub
- URL: https://github.com/robertpsoane/ducker
- Owner: robertpsoane
- License: mit
- Created: 2024-06-15T06:32:11.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2024-09-09T21:22:20.000Z (3 months ago)
- Last Synced: 2024-09-10T20:52:22.410Z (3 months ago)
- Topics: developer-tools, docker, ratatui-rs
- Language: Rust
- Homepage: https://crates.io/crates/ducker
- Size: 5.8 MB
- Stars: 239
- Watchers: 3
- Forks: 11
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-ratatui - ducker - A terminal app for managing docker containers, inspired by K9s. (๐ป Apps / ๐จโ๐ป System Administration)
- awesome-tuis - ducker
README
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:
```bash
cargo install --locked ducker
```
> :warning: **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](https://archlinux.org/packages/extra/x86_64/ducker/) with using [pacman](https://wiki.archlinux.org/title/pacman).
```sh
pacman -S ducker
```### Brew
For macOS, you can install `ducker` using by `homebrew`.
```sh
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 |> :warning: **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'
```