#docker #tui #tokio #terminal #podman

app oxker

A simple tui to view & control docker containers

17 releases

0.2.5 Mar 13, 2023
0.2.3 Feb 4, 2023
0.1.10 Dec 25, 2022
0.1.7 Nov 13, 2022
0.1.2 Jul 23, 2022

#44 in Command line utilities

Download history 54/week @ 2022-11-29 41/week @ 2022-12-06 14/week @ 2022-12-13 29/week @ 2022-12-20 25/week @ 2022-12-27 48/week @ 2023-01-03 14/week @ 2023-01-10 27/week @ 2023-01-17 49/week @ 2023-01-24 75/week @ 2023-01-31 50/week @ 2023-02-07 61/week @ 2023-02-14 35/week @ 2023-02-21 49/week @ 2023-02-28 19/week @ 2023-03-07 72/week @ 2023-03-14

190 downloads per month

MIT license

3.5K SLoC


A simple tui to view & control docker containers

Built in Rust, making heavy use of tui-rs & Bollard

Download & install


Published on crates.io, so if you have cargo installed, simply run

cargo install oxker


Published on Docker Hub, with images built for linux/amd64, linux/arm64, and linux/arm/v6

docker run --rm -it -v /var/run/docker.sock:/var/run/docker.sock:ro --pull=always mrjackwills/oxker


Using nix flakes, oxker can be ran directly with

nix run nixpkgs#oxker

Without flakes, you can build a shell that contains oxker using

nix-shell -p oxker


oxker can be installed from the AUR with using an AUR helper:

paru -S oxker


See the pre-built binaries

or, download & install (x86_64 one liner)

wget https://www.github.com/mrjackwills/oxker/releases/latest/download/oxker_linux_x86_64.tar.gz &&
tar xzvf oxker_linux_x86_64.tar.gz oxker &&
install -Dm 755 oxker -t "${HOME}/.local/bin" &&
rm oxker_linux_x86_64.tar.gz oxker

or, for automatic platform selection, download, and installation (to $HOME/.local/bin)

One should always verify script content before running in a shell

curl https://raw.githubusercontent.com/mrjackwills/oxker/main/install.sh | bash



In application controls

button result
( tab ) or ( shift+tab ) change panel, clicking on a panel also changes the selected panel
( ↑ ↓ ) or ( j k ) or ( PgUp PgDown ) or ( Home End ) change selected line in selected panel, mouse scroll also changes selected line
( enter ) execute selected docker command
( 1-9 ) sort containers by heading, clicking on headings also sorts the selected column
( 0 ) stop sorting
( h ) toggle help menu
( m ) toggle mouse capture - if disabled, text on screen can be selected
( q ) to quit at any time

Available command line arguments

argument result
-d [number > 0] set the minimum update interval for docker information, in ms, defaults to 1000 (1 second)
-r show raw logs, by default oxker will remove ANSI formatting (conflicts with -c)
-c attempt to color the logs (conflicts with -r)
-t remove timestamps from each log entry
-s if running via docker, will show the oxker container
-g no tui, basically a pointless debugging mode, for now

Build step


cargo build --release

Raspberry pi

requires docker & cross-rs

64bit pi (pi 4, pi zero w 2)

cross build --target aarch64-unknown-linux-gnu --release

32bit pi (pi zero w)

Tested, and fully working on pi zero w, running Raspberry Pi OS 32 bit, the initial logs parsing can take an extended period of time if thousands of lines long, suggest running with a -d argument of 5000

cross build --target arm-unknown-linux-musleabihf --release

If no memory information available, try appending /boot/cmdline.txt with

cgroup_enable=cpuset cgroup_enable=memory

see https://forums.raspberrypi.com/viewtopic.php?t=203128 and https://github.com/docker/for-linux/issues/1112

Untested on other platforms


As of yet untested, needs work

cargo test -- --test-threads=1

Run some example docker images

using docker-compose.yml;

docker compose -f docker-compose.yml up -d

or individually

docker run --name redis -d redis:alpine3.17
docker run --name postgres -e POSTGRES_PASSWORD=never_use_this_password_in_production -d postgres:alpine3.17
docker run -d --hostname my-rabbit --name rabbitmq rabbitmq:3


~410K SLoC