oxker

A simple tui to view and control docker containers

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

Download & install

See releases

install

INSTALL_DIR="${HOME}/.local/bin"
tar xzvf oxker_linux_x86_64.tar.gz oxker
install -Dm 755 oxker -t "$INSTALL_DIR"
rm oxker_linux_x86_64.tar.gz oxker

Run

oxker

available command line arguments

argument	result
-d [number > 0]	set the update interval for docker information, in ms
-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
-g	No tui, basically a pointless debugging mode, for now

Build step

x86_64

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

Compress executable

compress output from ~3mb to ~1mb

upx --best --lzma target/release/oxker -o ./oxker

Untested on other platforms

Tests

As of yet untested, needs work

cargo test -- --test-threads=1

Run some example docker images

docker run --name redis -d redis:alpine3.15

docker run --name postgres -e POSTGRES_PASSWORD=never_use_this_password_in_production -d postgres:alpine

docker run -d --hostname my-rabbit --name rabbitmq rabbitmq:3