⚓ Wharf

A terminal UI for managing Docker Compose stacks. Inspired by k9s.

Features

• Browse and manage Docker Compose projects and services
• Compose up / stop / down / restart / build / validate
• Docker Compose profiles support (:up <profile> / :up *)
• Exec into containers with shell banner
• Real-time CPU/MEM/Network monitoring with braille charts (Top View)
• Stream container logs with follow/pause and search
• Browse files inside containers (File Browser)
• Edit compose files with your $EDITOR
• Inspect container details — ports, volumes, environment, networks, health checks
• Manage volumes, networks, and images
• Docker System overview with disk usage
• Live Docker events monitoring
• Custom commands from config with template variables
• Command mode with Tab-autocomplete (:exec, :go, :validate, :theme, :host, :up...)
• Remote Docker host via SSH (:host ssh://user@server)
• Host Switcher (H) — saved hosts with add/delete, connect by name
• Bookmark favorite projects (★), bulk operations (Space)
• Vim-style navigation (hjkl, gg/G, /, :q, arrows)
• Customizable themes (dark/light/custom YAML)
• Single binary, zero dependencies

Quick Start

Install (Linux/macOS)

curl -sL https://raw.githubusercontent.com/idesyatov/wharf/master/scripts/install.sh | bash

Homebrew

brew tap idesyatov/tap
brew install wharf

Download binary

Download from GitHub Releases:

From source

git clone https://github.com/idesyatov/wharf.git
cd wharf
make docker-build-all    # Go not required — builds via Docker

Usage

wharf            # start TUI
wharf --version  # show version
wharf --config   # show config path and current settings

# ~/.config/wharf/config.yaml
custom_commands:
  - name: "Rails Console"
    key: "1"
    command: "docker exec -it {{.ContainerID}} rails console"
  - name: "Run Tests"
    key: "2"
    command: "docker exec -it {{.ContainerID}} bundle exec rspec"

Configuration

# ~/.config/wharf/config.yaml
poll_interval: 2s
log_tail: 100
max_log_lines: 1000
theme: dark
docker_host: ""
mouse: false
bookmarks:
  - my-project
hosts:
  - name: "prod"
    url: "ssh://deploy@prod.example.com"
  - name: "staging"
    url: "ssh://deploy@staging.srv"
keybindings:
  quit: "ctrl+q"

Custom themes: ~/.config/wharf/themes/<n>.yaml

Examples

See examples/ for sample compose projects:

Tech Stack

Go + Bubbletea + Lipgloss + Docker SDK

Contributing

Contributions are welcome! See CONTRIBUTING.md for details.

License

MIT — see LICENSE.