VPSMonitor

A native macOS menu bar app for monitoring multiple Linux VPS hosts over SSH

No agent. No cloud. No setup on the server side.

English · Русский · Español · 中文 · Download · Support

What it does

VPSMonitor lives in your menu bar and shows live state of your Linux servers in real time. It connects over SSH using your existing keys (or a password), runs a small read-only bash script remotely, and brings the result back to a clean native dashboard — without installing anything on the server.

Features


🚀 Zero server-side setup	No agent to install, no daemon to keep alive, no open port
🔒 Privacy by design	Local-first: data never leaves your Mac. Passwords stored in macOS Keychain
📊 Per-service stats	CPU and RAM consumed by each running service, not just totals
🔍 Smart project discovery	Scans `/opt`, `/var/www`, `/srv`, `/app`, `/home/*`, links projects to `systemd` units and live processes
🔔 Push notifications	macOS alerts when a server goes down, recovers, or a service stops
📈 Metric history	Local history, sparkline charts and a dedicated history window
🧭 Incident analysis	Highlights anomalies, builds a copyable incident snapshot and suggests manual check commands
🌐 Multiple servers	Add, edit, delete from Settings — selectable from the sidebar and the menu bar
🏳️ Country flags	IP-based country lookup with local caching, all-country search and manual override
🌍 App languages	Russian, English, Spanish and Chinese selectable inside the app
🔑 Key or password auth	Use existing SSH keys or store credentials securely in Keychain
🆕 Auto-update check	Tells you when a new release is available on GitHub

Screenshots

Interface languages


_English	_{Русский}

_Español	_中文

Product tour


_{Incident analysis, baselines and copyable report}	_{Per-service CPU/RAM, project paths and code-only folders}

_{Add/edit/delete VPS, SSH key or password, app language}	_{Country search, GeoIP auto mode and manual override}

_{Hide noisy projects and manage new detections}	_{Local metric history with CPU, RAM, disk and latency charts}

_{Menu bar: all servers and actions at a glance}	_{Manual check commands with one-click copy actions}

Requirements

Requirement	Version
macOS	14 Sonoma or later
SSH access to your server	key-based or password
Xcode Command Line Tools	for building from source

Install

Option A — download a release (recommended)

Grab the latest VPSMonitor.dmg from Releases
Open the DMG and drag VPSMonitor.app to /Applications
Launch — click the menu bar icon → Settings → add your first VPS

Option B — build from source

git clone https://github.com/thealexpm/VPSMonitor.git
cd VPSMonitor
./script/build_and_run.sh

The script compiles, ad-hoc-signs the bundle, drops it in dist/VPSMonitor.app, and launches it.

Setting up SSH access

The app uses whatever SSH key is already loaded in your agent or configured in ~/.ssh/config. To make sure it works:

ssh user@your.server.address "echo ok"

If you see ok, the app will connect. If you'd rather not use keys — add the server in Settings with Подключение → Логин и пароль and store credentials in macOS Keychain.

Connect with IP, login and password

An SSH key is optional. You can connect a server manually without editing ~/.ssh/config:

Open Settings and add a new VPS
Enter the server IP address or hostname
Enter the SSH login
Select Подключение → Логин и пароль
Enter the password — VPSMonitor stores it securely in macOS Keychain

The app still uses the standard SSH protocol under the hood, but no preconfigured SSH key is required.

For non-standard ports add a Host block to ~/.ssh/config:

Host my-vps
    HostName your.server.address
    User root
    Port 2222
    IdentityFile ~/.ssh/id_ed25519

Then use my-vps as the host inside the app.

Why not Uptime Kuma, Netdata or Better Stack?

VPSMonitor is not trying to replace a full observability platform. It is for a different use case: a Mac user who wants to keep an eye on a few Linux VPS hosts without installing an agent, opening another port, or sending server data to a cloud service.

Tool	Best for	Trade-off
VPSMonitor	Native macOS, SSH-only checks, project discovery, local-first workflow	macOS-only, not a team SaaS dashboard
Uptime Kuma	Self-hosted uptime pages and notifications	Requires running a monitoring service somewhere
Netdata	Deep real-time metrics and dashboards	Requires an agent on each server
Better Stack	Hosted uptime, incidents, status pages and team workflows	Cloud service, paid tiers for serious usage

If you want a lightweight menu bar view of your own VPS fleet, VPSMonitor is the smallest moving piece: open the app, add SSH access, and monitor from your Mac.

How it works

Every refresh cycle:

Opens an SSH connection using your key or stored password
Pipes a self-contained bash script via stdin to bash -s — no files are written
The script reads /proc/stat, /proc/meminfo, df, /proc/uptime, systemctl and ps
Output is parsed on the Mac side
Projects are matched by directory + WorkingDirectory of each systemd unit
Per-service CPU and RAM are fetched via ps -p <MainPID> -o %cpu= -o rss=

The server is never modified. The script exits cleanly each run.

Project structure

Sources/
  VPSMonitor/           SwiftUI app: menu bar, dashboard, settings, help, about
  VPSMonitorCore/       Models, services, SSH, Keychain, i18n, GeoIP, update checker
  VPSMonitorProbe/      CLI probe for testing SSH connectivity
Tests/
  VPSMonitorCoreTests/  Unit tests for the inventory parser
Resources/
  AppIcon.icns          App icon
  screenshots/          README screenshots
script/
  build_and_run.sh      One-command build + launch (ad-hoc signed)
  release.sh            Developer-ID signed + notarized release builder
  package_unsigned.sh   Local unsigned ZIP/DMG package for testing

Releasing (for maintainers)

For signed/notarized builds you'll need an Apple Developer Program membership ($99/year). Then:

export DEV_ID_NAME="Developer ID Application: Your Name (TEAMID)"
export NOTARY_PROFILE="VPSMonitor-Notary"
./script/release.sh 1.1

Outputs dist/VPSMonitor-1.1.dmg ready to upload to GitHub Releases. See comments at the top of script/release.sh for one-time setup details.

Support and contributions

If VPSMonitor is useful to you, please star the repo. It helps other Mac and self-hosting users discover the project.
Issues and feature requests: GitHub Issues
Direct contact: @thealexpm on Telegram
Pull requests welcome
Thanks to Angel-M-R for the first public fork and the ideas behind local SSH server import, SSH password fallback, clearer connection errors, and hidden-project-aware health status.

License

MIT — see LICENSE.

Что это

VPSMonitor — нативное macOS-приложение, которое живёт в строке меню и в реальном времени показывает состояние ваших Linux-серверов. Подключается по SSH вашими ключами или паролем, запускает удалённо небольшой read-only bash-скрипт и приносит результат в чистый нативный дашборд. На сервер ничего ставить не нужно.

Возможности


🚀 Ноль настройки на сервере	Никаких агентов, демонов или открытых портов
🔒 Приватность	Всё локально на Mac. Пароли — в Связке ключей macOS
📊 Статистика по службам	CPU и RAM по каждой работающей службе, а не только суммарно
🔍 Умный поиск проектов	Сканирует `/opt`, `/var/www`, `/srv`, `/app`, `/home/*` и связывает папки с `systemd`-юнитами и живыми процессами
🔔 Push-уведомления	Алёрт macOS когда сервер падает, восстанавливается или служба остановилась
📈 История метрик	Локальная история, спарклайны и отдельное окно графиков
🧭 Разбор инцидента	Подсвечивает отклонения, копирует snapshot инцидента и предлагает команды проверки
🌐 Несколько серверов	Добавление, редактирование, удаление в настройках
🏳️ Флаги стран	GeoIP lookup по IP с локальным кэшем, поиск по всем странам и ручной override
🌍 Языки приложения	Русский, английский, испанский и китайский переключаются внутри приложения
🔑 Ключ или пароль	Существующий SSH-ключ или пароль в Связке ключей
🆕 Авто-проверка обновлений	Сообщает когда вышла новая версия на GitHub

Скриншоты


_{Разбор инцидента, база метрик и копируемый отчёт}	_{CPU/RAM по службам, пути проектов и папки без привязанной службы}

_{Серверы, язык интерфейса, ключ или пароль}	_{Поиск страны, автоопределение по IP и ручной override}

_{Скрытие шумных проектов и управление новыми находками}	_{Локальная история CPU, RAM, диска и latency}

_{Строка меню: все серверы и действия на одном экране}	_{Команды ручной проверки с копированием в один клик}

Требования

Требование	Версия
macOS	14 Sonoma или новее
SSH-доступ к серверу	ключ или пароль
Xcode Command Line Tools	для сборки из исходников

Установка

Вариант A — скачать релиз (рекомендуется)

Возьмите свежий VPSMonitor.dmg со страницы релизов
Откройте DMG и перетащите VPSMonitor.app в /Applications
Запустите — клик по иконке в menu bar → Настройки → добавьте первый VPS

Вариант B — собрать из исходников

git clone https://github.com/thealexpm/VPSMonitor.git
cd VPSMonitor
./script/build_and_run.sh

Скрипт компилирует, ad-hoc-подписывает, кладёт .app в dist/ и запускает.

SSH-доступ

Приложение использует тот SSH-ключ, который уже загружен в агент или прописан в ~/.ssh/config. Проверка:

ssh user@your.server.address "echo ok"

Если выводит ok — приложение тоже подключится. Если не хочется ключ — в настройках выберите Подключение → Логин и пароль, пароль сохранится в Связке ключей.

Подключение по IP, логину и паролю

SSH-ключ необязателен. Сервер можно подключить вручную без настройки ~/.ssh/config:

Откройте Настройки и добавьте новый VPS
Укажите IP-адрес или hostname сервера
Укажите логин SSH
Выберите Подключение → Логин и пароль
Введите пароль — VPSMonitor безопасно сохранит его в Связке ключей macOS

Внутри приложение по-прежнему использует стандартный протокол SSH, но заранее настроенный SSH-ключ не требуется.

Для нестандартного порта добавьте блок в ~/.ssh/config:

Host my-vps
    HostName your.server.address
    User root
    Port 2222
    IdentityFile ~/.ssh/id_ed25519

И укажите my-vps в качестве хоста.

Как работает

Каждый цикл опроса:

Открывается SSH-соединение по ключу или сохранённому паролю
Через stdin отправляется самодостаточный bash-скрипт — на сервере не создаются файлы
Скрипт читает /proc/stat, /proc/meminfo, df, /proc/uptime, systemctl и ps
Вывод парсится уже на Mac
Проекты связываются по совпадению пути и WorkingDirectory юнитов
CPU и RAM по службам берутся через ps -p <MainPID> -o %cpu= -o rss=
Процессы без systemd связываются с проектами по рабочей директории и командной строке
Страна VPS определяется по IP один раз, сохраняется локально и может быть изменена вручную

Сервер ничего не записывает. Скрипт завершается чисто после каждого запуска.

Español

Qué es

VPSMonitor es una aplicación nativa para macOS que vive en la barra de menú y muestra el estado de sus servidores Linux en tiempo real. Se conecta por SSH con sus claves o contraseña, ejecuta remotamente un pequeño script bash de solo lectura y muestra los datos en un panel nativo. No instala nada en el servidor.

Funciones


🚀 Sin instalación en el servidor	No hay agente, daemon ni puerto adicional
🔒 Privacidad local	Los datos se quedan en el Mac. Las contraseñas se guardan en macOS Keychain
📊 Estadísticas por servicio	CPU y RAM por servicio o proceso, no solo métricas totales
🔍 Descubrimiento inteligente	Escanea `/opt`, `/var/www`, `/srv`, `/app`, `/home/*` y enlaza carpetas con `systemd` y procesos vivos
🔔 Notificaciones	Alertas de macOS cuando un servidor cae, se recupera o un servicio se detiene
📈 Historial de métricas	Historial local, sparklines y una ventana dedicada con gráficos
🧭 Análisis de incidentes	Detecta desviaciones, crea un snapshot copiable y sugiere comandos manuales
🌐 Varios servidores	Añadir, editar, eliminar y seleccionar VPS desde la barra lateral o la barra de menú
🏳️ Banderas de país	GeoIP por IP con caché local, búsqueda de todos los países y override manual
🌍 Idiomas	Ruso, inglés, español y chino, seleccionables dentro de la app
🔑 Clave o contraseña	Use claves SSH existentes o contraseña guardada en Keychain
🆕 Comprobación de actualizaciones	Avisa cuando hay una nueva versión en GitHub

Capturas


_{Análisis de incidentes, base de métricas e informe copiable}	_{Servicios activos, carpetas de código y consumo por proceso}

_{Servidores, idioma, clave SSH o contraseña}	_{Búsqueda de país, GeoIP automático y selección manual}

_{Historial local de CPU, RAM, disco y latencia}	_{Todos los servidores y acciones desde la barra de menús}

Requisitos

Requisito	Versión
macOS	14 Sonoma o posterior
Acceso SSH al servidor	clave o contraseña
Xcode Command Line Tools	para compilar desde el código fuente

Instalación

Opción A - descargar un release

Descargue VPSMonitor.dmg desde Releases
Abra el DMG y arrastre VPSMonitor.app a /Applications
Inicie la app, abra Settings/Ajustes y añada su primer VPS

Opción B - compilar desde el código fuente

git clone https://github.com/thealexpm/VPSMonitor.git
cd VPSMonitor
./script/build_and_run.sh

El script compila la app, firma ad-hoc el bundle, lo deja en dist/VPSMonitor.app y lo inicia.

Acceso SSH

VPSMonitor usa las claves que ya estén cargadas en el agente SSH o configuradas en ~/.ssh/config. Compruebe primero:

ssh user@your.server.address "echo ok"

Si devuelve ok, VPSMonitor también podrá conectarse. Si prefiere no usar claves, añada el servidor con Connection -> Username and password y la contraseña se guardará en macOS Keychain.

Para puertos no estándar, añada un bloque en ~/.ssh/config:

Host my-vps
    HostName your.server.address
    User root
    Port 2222
    IdentityFile ~/.ssh/id_ed25519

Luego use my-vps como host dentro de la app.

Cómo funciona

En cada ciclo de comprobación:

Abre una conexión SSH con clave o contraseña guardada
Envía un script bash autónomo por stdin a bash -s
El script lee /proc/stat, /proc/meminfo, df, /proc/uptime, systemctl y ps
El resultado se analiza en el Mac
Los proyectos se enlazan por directorio, WorkingDirectory, cwd y línea de comandos
CPU y RAM se leen por servicio o proceso con ps
El país del VPS se resuelve por IP una vez, se guarda localmente y puede cambiarse manualmente

El servidor no se modifica. El script termina después de cada ejecución.

Estructura del proyecto

Sources/
  VPSMonitor/           App SwiftUI: barra de menú, dashboard, ajustes, ayuda, about
  VPSMonitorCore/       Modelos, SSH, Keychain, i18n, GeoIP, update checker
  VPSMonitorProbe/      CLI para probar conectividad SSH
Tests/
  VPSMonitorCoreTests/  Tests del parser, incidentes y presentación de países
Resources/
  AppIcon.icns          Icono
  screenshots/          Capturas para README
script/
  build_and_run.sh      Compilar y lanzar
  release.sh            Build firmado y notarizado
  package_unsigned.sh   ZIP/DMG unsigned para pruebas locales

Soporte

Issues y propuestas: GitHub Issues
Contacto directo: @thealexpm en Telegram
Pull requests son bienvenidos

中文

这是什么

VPSMonitor 是原生 macOS 菜单栏应用，用于通过 SSH 实时监控多个 Linux VPS。它使用现有 SSH 密钥或密码连接服务器，远程运行一个只读 bash 脚本，并在原生仪表盘中显示结果。服务器端无需安装任何代理。

功能


🚀 服务器零安装	无需代理、daemon 或额外开放端口
🔒 本地优先隐私	数据留在 Mac 上，密码存储在 macOS Keychain
📊 按服务统计	显示每个服务或进程的 CPU 和内存，而不仅是总量
🔍 智能项目发现	扫描 `/opt`、`/var/www`、`/srv`、`/app`、`/home/*`，并关联 `systemd` 与运行进程
🔔 系统通知	服务器宕机、恢复或服务停止时发送 macOS 通知
📈 指标历史	本地历史、sparkline 和独立图表窗口
🧭 事件分析	标出异常，生成可复制的 incident snapshot，并给出手动检查命令
🌐 多服务器	在设置、侧边栏和菜单栏中添加、编辑、删除和切换 VPS
🏳️ 国家/地区旗帜	基于 IP 的 GeoIP、本地缓存、全国家搜索和手动覆盖
🌍 界面语言	俄语、英语、西班牙语和中文，可在应用内切换
🔑 密钥或密码	使用现有 SSH 密钥，或将密码安全存入 Keychain
🆕 更新检查	GitHub 有新版本时提示

截图


_{事件分析、指标基线和可复制报告}	_{运行服务、代码目录和进程资源占用}

_{服务器、界面语言、SSH 密钥或密码}	_{国家/地区搜索、自动 GeoIP 和手动覆盖}

_{CPU、内存、磁盘和延迟的本地历史}	_{从菜单栏查看所有服务器和操作}

要求

要求	版本
macOS	14 Sonoma 或更新
SSH 访问	SSH 密钥或密码
Xcode Command Line Tools	从源码构建时需要

安装

方式 A - 下载 release

从 Releases 下载 VPSMonitor.dmg
打开 DMG，将 VPSMonitor.app 拖入 /Applications
启动应用，打开 Settings/设置，添加第一个 VPS

方式 B - 从源码运行

git clone https://github.com/thealexpm/VPSMonitor.git
cd VPSMonitor
./script/build_and_run.sh

脚本会编译应用、进行 ad-hoc 签名、将 .app 放入 dist/VPSMonitor.app 并启动。

SSH 访问

VPSMonitor 使用已加载到 SSH agent 或写在 ~/.ssh/config 中的密钥。先测试：

ssh user@your.server.address "echo ok"

如果返回 ok，应用也可以连接。如果不想使用密钥，可以在设置中选择 Connection -> Username and password，密码会存储在 macOS Keychain。

非标准端口可以在 ~/.ssh/config 中添加：

Host my-vps
    HostName your.server.address
    User root
    Port 2222
    IdentityFile ~/.ssh/id_ed25519

然后在应用中使用 my-vps 作为 host。

工作方式

每次刷新时：

使用 SSH 密钥或保存的密码打开连接
通过 stdin 将自包含 bash 脚本发送给 bash -s
脚本读取 /proc/stat、/proc/meminfo、df、/proc/uptime、systemctl 和 ps
输出在 Mac 端解析
项目通过目录、WorkingDirectory、cwd 和命令行关联
每个服务或进程的 CPU/RAM 通过 ps 获取
VPS 国家/地区通过 IP 解析一次，本地保存，也可以手动修改

服务器不会被写入。脚本每次运行后都会退出。

项目结构

Sources/
  VPSMonitor/           SwiftUI 应用：菜单栏、仪表盘、设置、帮助、关于
  VPSMonitorCore/       模型、SSH、Keychain、i18n、GeoIP、更新检查
  VPSMonitorProbe/      用于测试 SSH 连接的 CLI
Tests/
  VPSMonitorCoreTests/  parser、incident 和国家显示测试
Resources/
  AppIcon.icns          应用图标
  screenshots/          README 截图
script/
  build_and_run.sh      编译并启动
  release.sh            签名和 notarization release 构建
  package_unsigned.sh   本地测试用 unsigned ZIP/DMG

支持

Issues 和功能建议: GitHub Issues
直接联系: Telegram @thealexpm
欢迎 Pull requests
感谢 Angel-M-R 的第一个公开 fork，以及关于本地 SSH 服务器导入、SSH 密码 fallback、更清晰连接错误和隐藏项目感知健康状态的想法。

许可证

MIT — 见 LICENSE。

Name		Name	Last commit message	Last commit date
Latest commit History 21 Commits
.codex/environments		.codex/environments
Resources		Resources
Sources		Sources
Tests/VPSMonitorCoreTests		Tests/VPSMonitorCoreTests
docs		docs
script		script
.gitignore		.gitignore
LICENSE		LICENSE
Package.swift		Package.swift
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation

VPSMonitor

What it does

Features

Screenshots

Interface languages

Product tour

Requirements

Install

Option A — download a release (recommended)

Option B — build from source

Setting up SSH access

Connect with IP, login and password

Why not Uptime Kuma, Netdata or Better Stack?

How it works

Project structure

Releasing (for maintainers)

Support and contributions

License

Что это

Возможности

Скриншоты

Требования

Установка

Вариант A — скачать релиз (рекомендуется)

Вариант B — собрать из исходников

SSH-доступ

Подключение по IP, логину и паролю

Как работает

Español

Qué es

Funciones

Capturas

Requisitos

Instalación

Opción A - descargar un release

Opción B - compilar desde el código fuente

Acceso SSH

Cómo funciona

Estructura del proyecto

Soporte

中文

这是什么

功能

截图

要求

安装

方式 A - 下载 release

方式 B - 从源码运行

SSH 访问

工作方式

项目结构

支持

许可证

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 4

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages