main
PXmon
Current release: v0.2.0. The original GitHub repository is archived; active public source now lives on Gitea.
PXmon (Phylex Monitor) is a terminal-first SSH cluster manager and monitoring tool with a built-in TUI, agent bootstrap flow, alerting, reporting, backups, and runbook/scheduler automation.
Highlights
- Bubble Tea dashboard (
overview,clusters,network,settings,docs,usage,live) - Secure encrypted local cluster registry
- SSH and optional SSH-tunneled agent transport (
direct/ipfabric) - Remote command execution and embedded SSH workflows
- Agent bootstrap, status checks, version checks, and updates
- Alerts (CPU/RAM/SWAP/DISK/NET), VM alerts, and alert routing
- Drift detection, SLO reporting, capacity forecast, and traffic p95
- Backup targets/plans (SFTP/S3), runbooks, and scheduled tasks
- RepoTunneling for temporary package repository access through a controlled gateway
- Telegram bot controls
- Encrypted export/import bundles, including referenced key files
Requirements
- Go
1.25+ - Linux/macOS terminal (interactive features require TTY)
- SSH reachability to target nodes
Quick start
git clone https://git.datacoria.com/endssh/pxmon.git
cd pxmon
go build -o bin/pxmon ./cmd/pxmon
go build -o bin/pxmon-agent ./cmd/pxmon-agent
./bin/pxmon
Or run by command:
./bin/pxmon cluster help
./bin/pxmon tui
Core commands
pxmon cluster ...pxmon tuipxmon clusterspxmon networkpxmon cluster exec ...pxmon cluster repo-tunnel ...pxmon bot telegram ...pxmon locker ...pxmon config export|import ...pxmon explain --find <text>
Documentation
- Install Guide
- Usage Guide
- Command Reference
- TUI Guide
- Architecture
- Feature Overview
- RepoTunneling
- Releases and Versioning
- Publish Guide
Default config location
By default PXmon stores encrypted registry data in:
- Linux:
~/.config/pxmon/clusters.enc - macOS:
~/Library/Application Support/pxmon/clusters.enc
You can override using:
PXMON_CONFIGPXMON_MASTER_KEY--config /path/to/clusters.enc
Open source metadata
- License: MIT
- Version:
VERSION - Changelog: CHANGELOG.md
- Security: SECURITY.md
- Contributing: CONTRIBUTING.md