Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

FTMON

FTMON monitor dial logo

FTMON is a lightweight, local systems monitor for Linux, Windows, and macOS desktops, workstations, and standalone servers. It detects problems such as memory leaks, CPU hogs, disks filling, service failures, and notable journal / Event Log events while keeping bounded metric history on the monitored machine.

It is designed for people who need more history and alerting than htop or btop, but do not need a central monitoring stack such as Nagios, Zabbix, or Prometheus and Grafana for one independently managed server.

Development status: FTMON v2 is pre-release software. Interfaces and data formats may change before the first stable release.

Live demo: Explore the read-only interface at demo.ftmon.org. It uses clearly labelled synthetic data and does not monitor the demo server or expose an operational FTMON installation.

Architecture

FTMON runs as separate processes on one host. The daemon samples the system, evaluates declarative TOML monitors, and writes to a local SQLite database; the CLI, loopback web dashboard, and stdio MCP server read the same store (and perform a few narrow writes such as ack and draft approval). Monitor definitions are data validated at load time, not code loaded into the daemon.

  • Processes: CLI, daemon, loopback web UI, and stdio MCP server.
  • Daemon path: scheduler → samplers / external checks → pipeline → incident engine → store writer → SQLite; notifications leave from the daemon.
  • Readers: CLI, web UI, and MCP read (and lightly write) the same SQLite store.

The web UI listens on loopback only; MCP uses stdio. PyPI's Markdown renderer does not support Mermaid, so the flowchart lives in DESIGN.md (rendered on GitHub). For packaging layering rules, see the same document.

Why FTMON?

  • Runs locally as your user or a dedicated service account, without a central monitoring server or cloud account.
  • Provides a CLI and accessible offline web dashboard with historical charts.
  • Stores metrics and incidents in SQLite with bounded retention.
  • Uses editable, declarative TOML monitor definitions.
  • Sends durable alerts through email, ntfy, generic webhooks, or desktop notifications, with each channel retrying independently.
  • Offers a local stdio MCP server for AI-assisted investigation and definition drafting, with explicit user approval for changes.
  • Ships deterministic unit and end-to-end tests for its monitoring behavior.

A practical monitor for one server

FTMON is suitable for a small hosted server, VPS, home server, or lab machine that needs dependable local monitoring without operating a separate monitoring platform. The server profile disables desktop popups, runs under a dedicated unprivileged account, retains history locally, and can notify an administrator through remote channels when an incident opens or recovers.

The operational dashboard remains bound to loopback and is reached through an SSH tunnel. This keeps the unauthenticated management interface off the public Internet while still making it useful on a remote headless host. A hardened systemd unit and complete single-server installation procedure are provided in the installation guide.

Bring your own checks

FTMON opens the collection boundary without turning the daemon into a general plugin host. Administrators can register local scripts or separately installed Nagios-compatible plugins, then use ordinary declarative monitor definitions to add confirmation, incidents, notifications, history, baselines and Trends over their returned performance data.

That means an existing HTTP, TLS-certificate, DNS, mail, database, UPS or sensor check can answer “is it broken now?”, while FTMON adds “has it been degrading?” and “what changed before the incident?” The executable remains outside FTMON; AI-authored definitions may reuse an approved alias but cannot introduce a command or credentials. See External checks, Why FTMON?, and the normative contract in SPEC.md.

Quick start

Install

Windows: download the per-user x64 MSI from the GitHub Releases page (ftmon-<version>-windows-x64.msi), install it (no elevation), then:

ftmon init --profile desktop
Install-FTMONTasks.ps1
Start-ScheduledTask -TaskName 'FTMON daemon'
ftmon web   # optional; or Install-FTMONTasks.ps1 -IncludeWeb for logon start

Open http://127.0.0.1:8420/. Full MSI, Task Scheduler, upgrade, and uninstall steps are in the installation guide.

Linux / macOS / Windows with Python: FTMON requires Python 3.11 or newer and uv. The recommended operator install uses an isolated tool environment from PyPI:

uv tool install ftmon
ftmon init --profile desktop
ftmon check
ftmon daemon

In another terminal:

ftmon web

Then open http://127.0.0.1:8420/. FTMON binds only to loopback and the web UI loads no external assets. Prefer uv tool or pipx over a bare pip install ftmon into a shared environment. Upgrade, systemd, launchd, Task Scheduler, and server account setup are in the installation guide.

For a headless single server, initialize with --profile server. This writes explicit settings with desktop popups disabled; remote ntfy, webhook, and SMTP channels use environment or protected-file credential references and maintain independent durable retry state. The operational dashboard stays on loopback; reach it remotely with an SSH tunnel rather than exposing the unauthenticated UI through a public reverse proxy.

Develop from a checkout

git clone https://github.com/dannysheehan/ftmon.git
cd ftmon
uv sync
uv run ftmon init --profile desktop
uv run ftmon check
uv run ftmon daemon

The live public demonstration is a different, GET-only application over deterministic synthetic data. Its reproducible DNS, Caddy, systemd, verification, update, and rollback runbook is in the installation guide. Never expose an operational FTMON database as a demo.

Documentation

Original FTMON

This repository is a from-scratch Python successor to the original Fast Track Systems Monitor, a Perl monitoring engine first published in 2002. The original GPLv2 project and its downloads remain available from the official FTMON project on SourceForge.

The original source is not included in this repository. Keeping the projects separate makes their provenance and licensing boundaries clear: this v2 repository is MIT licensed, while the original SourceForge project is GPLv2.

Development

uv sync
uv run ruff check src tests
uv run pytest -q

Tests reference stable requirement IDs from SPEC.md. When changing behavior, update the relevant specification, design rationale, tests, and user documentation together.

License

FTMON v2 is available under the MIT License. The separately published original FTMON project retains its own GPLv2 license.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ftmon-2.0.0a16.tar.gz (1.1 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ftmon-2.0.0a16-py3-none-any.whl (572.9 kB view details)

Uploaded Python 3

File details

Details for the file ftmon-2.0.0a16.tar.gz.

File metadata

  • Download URL: ftmon-2.0.0a16.tar.gz
  • Upload date:
  • Size: 1.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ftmon-2.0.0a16.tar.gz
Algorithm Hash digest
SHA256 3eed917bfbfb3a77b6ca773800a188e03b9137d11278fd46ee94d54cceb06cea
MD5 68b2cdedb9a3a4e3dac0ba67096ae5c6
BLAKE2b-256 1e8b6d3a4349c770c6bd85bef8a58c7f31615a6b35bfd3f60151fdaf675a4465

See more details on using hashes here.

Provenance

The following attestation bundles were made for ftmon-2.0.0a16.tar.gz:

Publisher: release.yml on dannysheehan/ftmon

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file ftmon-2.0.0a16-py3-none-any.whl.

File metadata

  • Download URL: ftmon-2.0.0a16-py3-none-any.whl
  • Upload date:
  • Size: 572.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ftmon-2.0.0a16-py3-none-any.whl
Algorithm Hash digest
SHA256 b72dda6b127d4e8b00abfb2aee84dcf908316b069ce5e7fb4abaea591bf7380c
MD5 da1c8e18e2ca7309ce2b7bd8b125b19a
BLAKE2b-256 51a360908a9a86f4a9869e8af3ef89848ce69b12d37e1fea1fa982b534d7d8b3

See more details on using hashes here.

Provenance

The following attestation bundles were made for ftmon-2.0.0a16-py3-none-any.whl:

Publisher: release.yml on dannysheehan/ftmon

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page