README
¶
Nekomari
🐱 Nekomari is a fork of Komari
Base version:
1.5.0-fix1(commit0ca87aa, 2026-09-14) — the last release published before upstream was archived. Upstream is archived and no longer maintained; Nekomari continues it with new features. See FORK.md for full provenance and the change list.Licensed MIT, same as upstream. The original copyright (c) 2025 Komari Moniter is preserved verbatim in
LICENSEandNOTICE.
Nekomari is a lightweight, self-hosted server monitoring solution — a maintained continuation of Komari. It provides a simple and efficient way to track server performance through a web interface, with metrics collected by a lightweight agent.
[!WARNING] Nekomari is a self-hosted monitoring and control application. Deploy it only on systems you own or are authorized to manage. You are solely responsible for how you deploy and use it. The developers accept no liability for unauthorized access, persistence, command execution, other misuse, or any resulting consequences.
What Nekomari adds over upstream
| Change | Status |
|---|---|
netcheck — multi-protocol reachability probe (DNS + ICMP + TCP) that tells you which probe type a target actually supports |
✅ available |
Monorepo layout — server + frontend/ + agent/ in one repository |
✅ |
Bundled theme packer (tools/zstdpack) — builds without the zstd CLI (useful on Windows) |
✅ |
One-shot build script (build.sh) |
✅ |
| Further features in progress | 🚧 see FORK.md |
netcheck in 20 seconds
Monitoring tasks probe a target with one protocol (ICMP, TCP or HTTP). Pick the wrong one and you get a flat 100% packet loss — which looks like an outage but is really a protocol mismatch. netcheck tells you up front which one to use:
$ ./nekomari netcheck 1.51.3.134
ICMP probe (3x, timeout 3s)
x recv 0/3 loss 100% -- target does not answer ICMP
TCP probe (timeout 3s)
x 22 unreachable
v 80 open (handshake 2 ms)
v 443 open (handshake 2 ms)
----------------------------------------------------------
Verdict: TCP-only reachable (does not answer ICMP)
Advice: this target does NOT answer ICMP, but TCP:80,443 is open. Use a `tcp`
probe task and write the target as host:port (e.g. 1.51.3.134:80),
otherwise you will get 100% packet loss.
It also distinguishes "permission denied" from "target unreachable" — otherwise a non-privileged ICMP attempt leads to the opposite conclusion.
Features
- Real-time monitoring: Displays monitoring data at one-second intervals.
- Lightweight and efficient: Uses minimal system resources and works well on servers of any size.
- Self-hosted: Keeps you in control of your data and privacy.
- Web interface: Provides an intuitive, easy-to-use monitoring dashboard.
- Extensible: Supports custom themes and plugins.
Quick Start
| Platform | Description |
|---|---|
 |
Deploy websites, databases, and hundreds of popular apps in seconds with flexible hourly billing. Get started for just ¥5/month. Deploy now! |
 |
A modern, open-source Linux server management panel for websites, databases, containers, files, backups, security, and AI, with one-click deployment from its app store. |
For instructions on Docker deployment, binary installation, building from source, and updates, see the installation guide.
Screenshots
| Page | Screenshot |
|---|---|
| Home Dashboard |  |
| Admin Dashboard |  |
| History Charts |  |
| Web Terminal |  |
| Customizable Themes |  |
| Theme Market |  |
Sponsors
Interested in sponsoring Komari? Contact the developer via email or Telegram.
| Sponsor | Description |
|---|---|
 |
Self-Hosted Private CDN | Subscription-Based CDN-Like Service | A Fully Controlled, Flexible, Modular CDN Network |
 |
Cost-effective Asia-Pacific hosting with direct connectivity and robust DDoS protection, backed by transparent capacity claims. |
 |
Premium China-optimized connectivity from Asia-Pacific data centers, featuring low latency, high bandwidth, and Tbps-scale local DDoS mitigation. Join the Telegram community to participate in charitable initiatives and community giveaways. |
Contributors
Thanks to everyone who has contributed code, themes, plugins, documentation, translations, bug reports, or feedback to Komari.
Support the Project
If Komari has been useful to you, consider buying me a coffee. Thank you for your support!
| WeChat Pay | TRON Network |
|---|---|
 |
 |
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
agent
module
|
|
|
internal
|
|
|
lifecycle
Package lifecycle carries process-level requests without coupling web RPC handlers to the server runtime.
|
Package lifecycle carries process-level requests without coupling web RPC handlers to the server runtime. |
|
managedconfig
Package managedconfig implements the shared managed-configuration behavior used by themes and plugins.
|
Package managedconfig implements the shared managed-configuration behavior used by themes and plugins. |
|
plugin
Package plugin manages Komari plugins: ZIP packages with a komari-plugin.json manifest, mirroring the theme package format.
|
Package plugin manages Komari plugins: ZIP packages with a komari-plugin.json manifest, mirroring the theme package format. |
|
sqlitetune
Package sqlitetune applies a consistent SQLite baseline to every physical connection opened through database/sql.
|
Package sqlitetune applies a consistent SQLite baseline to every physical connection opened through database/sql. |
|
pkg
|
|
|
jsruntime
Package jsruntime host services for modules injected by the application.
|
Package jsruntime host services for modules injected by the application. |
|
jsruntime/crypto
Package crypto provides a Node.js-compatible crypto module backed by the Go standard library and golang.org/x/crypto.
|
Package crypto provides a Node.js-compatible crypto module backed by the Go standard library and golang.org/x/crypto. |
|
jsruntime/httpbody
Package httpbody provides bounded helpers for reading HTTP request or response bodies.
|
Package httpbody provides bounded helpers for reading HTTP request or response bodies. |
|
jsruntime/internal/bridge
Package bridge provides the small set of runtime services shared by host modules.
|
Package bridge provides the small set of runtime services shared by host modules. |
|
netcheck
Package netcheck 探测一个目标的可达性与「协议适配」。
|
Package netcheck 探测一个目标的可达性与「协议适配」。 |
|
protocol
|
|
|
log
Package logger provides the server's single runtime logging surface.
|
Package logger provides the server's single runtime logging surface. |
|
messageSender/outboundhttp
Package outboundhttp provides the HTTP client used by configurable notification senders.
|
Package outboundhttp provides the HTTP client used by configurable notification senders. |
|
web
|
|
|
backup
Package backup contains the shared upload preparation for backup restores.
|
Package backup contains the shared upload preparation for backup restores. |
|
filemanager
Package filemanager correlates panel file requests with agent responses.
|
Package filemanager correlates panel file requests with agent responses. |
|
migration
Package migration serves the authenticated database migration guide used by both legacy monitoring imports and Metric Store structure upgrades.
|
Package migration serves the authenticated database migration guide used by both legacy monitoring imports and Metric Store structure upgrades. |
|
recovery
Package recovery serves the small, authenticated web surface used when the monitoring database cannot be opened during startup.
|
Package recovery serves the small, authenticated web surface used when the monitoring database cannot be opened during startup. |
|
upload
Package upload provides the shared chunked archive upload flow.
|
Package upload provides the shared chunked archive upload flow. |