Skip to content

cobanov/bartainer-desktop

Repository files navigation

Bartainer

A native desktop app for monitoring Docker containers across local and remote hosts. Built with Tauri 2 and React.

Bartainer

Features

  • Live container list with state, image, ports, uptime, and CPU / memory / network stats
  • Tailing log viewer with pause and clear
  • Start, stop, restart, and remove containers from the UI
  • Local Docker auto-detected on macOS, Linux, and Windows
  • Remote hosts over SSH (system ssh, password, or key file) or plain TCP
  • Test connection before saving, so you know it works before persisting
  • Passwords and key passphrases stored in the OS keyring; nothing sensitive on disk
  • System tray with hide-to-tray on window close
  • Light and dark themes that follow your system

Install

Download the installer for your platform from the latest release:

Platform File
macOS Apple Silicon Bartainer-VERSION-macOS-AppleSilicon.app.tar.gz
macOS Intel Bartainer-VERSION-macOS-Intel.app.tar.gz
Windows x86_64 Bartainer-VERSION-Windows-x86_64.exe
Linux x86_64 Bartainer-VERSION-Linux-x86_64.AppImage or .deb

The app is unsigned, so the first launch shows a gatekeeper or SmartScreen warning. On macOS right-click the app and choose Open; on Windows click "More info" then "Run anyway"; on Linux chmod +x the AppImage before running.

Connecting a remote host

Click the + in the host sidebar and pick an auth method:

  • System ssh — Uses your local ssh binary. Works with ssh-agent keys, ~/.ssh/config aliases, and Tailscale SSH without any extra setup. Recommended if you already SSH to the host from a terminal.
  • Password — Type host, username, and password. The password is stored in the OS keyring.
  • Key file — Provide a username and the absolute path to a private key, plus a passphrase if the key is encrypted.

The remote needs Docker running and the SSH user in the docker group. Hit Test connection before saving to see whether everything lines up; the exact error from ssh or the daemon is shown inline.

Develop

pnpm install
pnpm tauri dev

Requires Node 20+, pnpm 9+, Rust stable (1.77+), and the Tauri 2 system dependencies.

A production bundle for your current platform:

pnpm tauri build

Artifacts land in src-tauri/target/release/bundle/.

Release

Bump the version in package.json, src-tauri/Cargo.toml, and src-tauri/tauri.conf.json, then push a matching tag:

git tag v0.X.Y && git push origin v0.X.Y

GitHub Actions builds for macOS Apple Silicon, macOS Intel, Windows, and Linux in parallel, then uploads renamed artifacts to a draft release. Publish it from the GitHub UI.

About

Cross-platform desktop app for monitoring and managing Docker containers across local and remote hosts.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Contributors