FleetTUI

A TUI for monitoring your server fleet in real-time. Built with Go and the Charm stack.

Features

• Real-time Monitoring: Track CPU, RAM, network usage, uptime, and systemd status
• Cards: Each node displayed in a detailed card with progress bars and status indicators
• List View: Compact tabular view for monitoring many nodes at once
• Parallel Collection: Fetches metrics from all hosts concurrently using goroutines
• Long-lived SSH Connections: Reuses SSH connections for efficient metrics collection
• Configurable: Enable/disable specific metrics via YAML configuration

Installation

From Source

git clone https://github.com/JustAlternate/fleettui.git
cd fleettui
go install .

Using Nix (with flakes)

nix run github:JustAlternate/fleettui

Usage

# Run with default config (~/.config/fleettui/)
fleettui

# Specify custom hosts file
fleettui -hosts ./hosts.yaml

Configuration

Hosts Configuration (hosts.yaml)

hosts:
  - name: server-01              # Display name (also used as IP if ip omitted)
    ip: 192.168.1.10             # IP address (default SSH port 22). Optional if name resolves.
    user: root                   # SSH user (default: root)
    ssh_key_path: ~/.ssh/id_rsa  # Optional: uses ssh-agent if not specified
  - name: server-02
    ip: 192.168.1.11:2222        # Custom SSH port supported
    user: admin

Notes:

• If ip is not specified, the name is used as the hostname/IP
• If user is not specified, defaults to root
• If ssh_key_path is not specified, uses ssh-agent if available
• Custom SSH port can be specified in ip field (e.g., 192.168.1.10:2222)

Application Configuration (config.yaml)

refresh_rate: 5s              # How often to refresh metrics
metrics:                      # Enabled metrics
  - cpu                       # CPU usage percentage
  - ram                       # RAM usage percentage
  - network                   # Network I/O rates (MB/s)
  - connectivity              # SSH connectivity status
  - uptime                    # System uptime
  - systemd                   # Failed systemd units
  - os                        # OS name from /etc/os-release

Requirements

• Remote hosts must have SSH access and read access to /proc filesystem (standard on Linux)

Development

# Clone and build
git clone https://github.com/JustAlternate/fleettui.git
cd fleettui
go build .

Testing

Run all tests:

go test ./...

Run with coverage:

go test -cover ./...

Generating Mocks

When interface changes require new mocks, run:

mockery --all

License

MIT License.

Inspiration

Inspired by k9s, a terminal UI for Kubernetes clusters.