Berth is a terminal-based UI to manage your containers, images, volumes, networks, and system usage — with support for Docker and Podman. Name origin: In maritime terms, a berth is a designated place where a ship is docked — just like containers in your stack. Clean, organized, and under control.
- ✨ Overview
- 🚀 Installation
- 🧭 Usage
- 🛠️ Technology Stack
- 📂 Project Structure
- 🚢 Release Process
- 🤝 Contributing
- 📜 License
Berth is a comprehensive terminal user interface (TUI) application built in Go, designed to simplify the management of Docker and Podman container environments. It provides a real-time, interactive experience for listing, inspecting, and controlling containers, images, volumes, and networks directly from your terminal. Berth aims to offer a k9s-like experience for container orchestration, focusing on usability, visual consistency, and efficient workflow.
# 1. Clone the repository
git clone https://github.com/rluders/berth.git
# 2. Enter the project directorycd berth
# 3. Build the binary
make build
# 4. Run it!
make runBerth provides an intuitive keyboard-driven interface.
| Key | Action |
|---|---|
1 | Containers view |
2 | Images view |
3 | Volumes view |
4 | Networks view |
5 | System view |
? | Toggle help overlay |
q / esc | Back / quit |
ctrl+c | Quit |
| Key | Action |
|---|---|
enter | Container details |
s | Start container |
x | Stop container |
r | Restart container |
d | Remove container |
l | View logs |
i | Inspect container |
e | Exec shell |
/ | Filter containers |
g | Toggle group by compose |
→ | Expand compose group |
← | Collapse compose group |
| Key | Action |
|---|---|
d | Remove image |
P | Prune dangling images |
/ | Filter images |
| Key | Action |
|---|---|
d | Remove volume |
/ | Filter volumes |
| Key | Action |
|---|---|
i | Inspect network |
| Key | Action |
|---|---|
b | Basic cleanup — stopped containers, unused networks, dangling images |
a | Advanced cleanup — basic + unused volumes |
t | Total cleanup — all unused resources |
| Key | Action |
|---|---|
p | Pause log stream |
f | Follow (tail) logs |
n | Toggle line numbers |
- Language: Go
- TUI Framework: Bubble Tea
- Styling: Lipgloss
- Reusable TUI Components: Bubbles
.
├── cmd/ # CLI entry point
├── internal/
│ ├── tui/ # Bubble Tea models, views, and components
│ ├── engine/ # Docker/Podman client abstraction
│ ├── service/ # Service layer (container, image, volume, network, system)
│ ├── controller/ # Action handlers (start, stop, remove, inspect, …)
│ └── utils/ # Formatting helpers and exec wrappers
├── docs/ # Assets (logo, screenshots)
├── go.mod
└── README.md
Releases are fully automated via GoReleaser and GitHub Actions.
git tag v1.2.3
git push origin v1.2.3Pushing a v*.*.* tag triggers the Release workflow, which:
- Runs all tests (
go test ./...) - Builds binaries for Linux, macOS, and Windows (amd64 + arm64)
- Packages archives (
tar.gzfor Unix,zipfor Windows) - Generates
checksums.txt - Publishes a GitHub Release with all artifacts
Follow Semantic Versioning: vMAJOR.MINOR.PATCH
- Tags matching
v*.*.*-*(e.g.v1.0.0-rc1) are published as pre-releases automatically. - No manual draft step — releases go live immediately.
| File | Description |
|---|---|
berth_VERSION_linux_amd64.tar.gz | Linux x86-64 binary |
berth_VERSION_linux_arm64.tar.gz | Linux ARM64 binary |
berth_VERSION_darwin_amd64.tar.gz | macOS x86-64 binary |
berth_VERSION_darwin_arm64.tar.gz | macOS ARM64 binary |
berth_VERSION_windows_amd64.zip | Windows x86-64 binary |
berth_VERSION_windows_arm64.zip | Windows ARM64 binary |
checksums.txt | SHA256 checksums for all archives |
We welcome contributions to Berth! If you're interested in improving the project, please consider:
- Reporting bugs or suggesting features via GitHub Issues.
- Submitting pull requests for bug fixes or new features. Please ensure your code adheres to the existing style and includes appropriate tests.
Made with contrib.rocks.