brynko-pulse
Open-source monitoring and alerts for Linux and Windows servers, developed by
brynko technologies. One small program watches the server and tells you within
seconds when something breaks, through the channels you choose: email,
WhatsApp (your own Meta account), Telegram, Slack or any webhook.
Status: v0.2. In daily use on our own Linux and Windows servers. Expect
rough edges, and please report what you find.
Why
- Runs on the server itself. No account, no cloud service, no telemetry.
- Outbound only. It never opens a network port.
- Plain files. Configuration is YAML, checked against a published JSON Schema, so mistakes are
caught with a clear message before anything runs.
- Quiet when it should be. Alerts wait for a problem to last, recover with a margin, catch
flapping, and fold storms into one message, so you trust the ones you get.
- Fast. Service, container, file and log changes are noticed as they happen.
- Fixes what it can. With self-healing, pulse restarts a failed service
or container, or runs your own fix, a limited number of times, and tells you what it did.
Install
Linux, on the server:
curl -fsSL https://github.com/Aadilkaifi/brynko-pulse/releases/latest/download/install.sh | sudo sh
Windows: one block to paste into PowerShell as Administrator, in Install.
Both download the latest release, check it against SHA256SUMS and start pulse as a service.
Packages, a specific version and uninstalling are in Install.
First steps
sudo pulse status # disk, memory, CPU and swap are watched; what install found is listed, inactive
sudoedit /etc/brynko-pulse/monitors/service-nginx.yaml # remove "enabled: false" to watch it
sudoedit /etc/brynko-pulse/channels.yaml # where alerts go
sudo pulse validate # says exactly what to fix
sudo pulse test channel ops-email # sends a test alert
sudo systemctl reload brynko-pulse # applies the change
Manage every server from one app
pulse is complete on its own. If you look after more than a few servers, the brynko devOps Agent
desktop app gives you one place for all of them:
- Install in one click on Linux and Windows servers over SSH, checked against the release
checksums. Nothing to download on the server.
- Every server at a glance: what each monitor watches, what it alerts on in plain words, and
what is failing right now.
- Forms instead of YAML, built from pulse itself, with the server's own disks, services,
containers and ports to pick from, and a check before anything is saved.
- Channels, silences, maintenance windows and defaults in a few clicks.
- An AI assistant that reads your servers and this guide, explains what is wrong, and makes
changes only after you approve each one.
The same app also works with your containers, databases, files and deploy scripts.
Download brynko devOps Agent and see
Using pulse from an app.
Documentation
| |
|---|
| Install | Linux and Windows, upgrade, uninstall |
| Configuration | Files, secrets, conditions, silences, maintenance windows |
| Monitors | Disk, memory, CPU, services, containers, ports, websites, certificates, logs, files, commands, heartbeats |
| Channels | Email, WhatsApp, Telegram, Slack, webhook |
| Self-healing | Restart a failed service or container, or run your own fix |
| Dead-server alert | Get an email when a whole server goes silent |
| Operations | Status, history, logs, troubleshooting |
| Command reference | Every command and flag |
| Configuration reference | Every config field |
| Using pulse from an app | The brynko devOps Agent desktop app: install, monitors, channels, settings |
| Building from source | Build, test, release |
Every command that prints data accepts --json. That output is a versioned contract
(api_version), so scripts and tools built on it keep working across releases.
Contributing
See CONTRIBUTING.md. Report security problems privately as described in
SECURITY.md.
Licence
GNU Affero General Public License v3.0 only. See LICENSE.
"brynko" and "brynko-pulse" are trademarks; see TRADEMARKS.md.
