Komari

!Badge (https://hitscounter.dev/api/hit?url=https%3A%2F%2Fgithub.com%2Fkomari-monitor%2Fkomari&label=&icon=github&color=%23a370f7&message=&style=flat&tz=UTC) Ask DeepWiki (https://deepwiki.com/badge.svg)

!komari (https://socialify.git.ci/komari-monitor/komari/image?description=1&font=Inter&forks=1&issues=1&language=1&logo=https%3A%2F%2Fraw.githubusercontent.com%2Fkomari-monitor%2Fkomari-web%2Fd54ce1288df41ead08aa19f8700186e68028a889%2Fpublic%2Ffavicon.png&name=1&owner=1&pattern=Plus&pulls=1&stargazers=1&theme=Auto)

简体中文 | 繁體中文 | 日本語

Komari is a lightweight, self-hosted server monitoring tool designed to provide a simple and efficient solution for monitoring server performance. It supports viewing server status through a web interface and collects data through a lightweight agent.

Documentation (https://komari-document.pages.dev/) | 文档(镜像站 By Geekertao) (https://www.komari.wiki) | Telegram Group (https://t.me/komari_monitor)

Features

• Lightweight and Efficient: Low resource consumption, suitable for servers of all sizes.
• Self-hosted: Complete control over data privacy, easy to deploy.
• Web Interface: Intuitive monitoring dashboard, easy to use.

Quick Start

0. One-click Deployment with Cloud Hosting

• Rainyun - CNY 4.5/month

(https://rainyun-apps.cn-nb1.rains3.com/materials/deploy-on-rainyun-cn.svg)

1. Use the One-click Install Script

Suitable for distributions using systemd (Ubuntu, Debian...).

curl -fsSL https://raw.githubusercontent.com/komari-monitor/komari/main/install-komari.sh -o install-komari.sh
chmod +x install-komari.sh
sudo ./install-komari.sh

2. Docker Deployment

1. Create a data directory:

   mkdir -p ./data
   

2. Run the Docker container:

   docker run -d \
     -p 25774:25774 \
     -v $(pwd)/data:/app/data \
     --name komari \
     ghcr.io/komari-monitor/komari:latest
   

3. View the default username and password:

   docker logs komari
   

4. Access http://:25774 in your browser.

[!NOTE] You can also customize the initial username and password through the environment variables ADMIN_USERNAME and ADMIN_PASSWORD.

3. Binary File Deployment

1. Visit Komari's GitHub Release page (https://github.com/komari-monitor/komari/releases) to download the latest binary for your operating system.
2. Run Komari:

   ./komari server -l 0.0.0.0:25774
   

3. Access http://:25774 in your browser. The default port is 25774.
4. The default username and password can be found in the startup logs or set via the environment variables ADMIN_USERNAME and ADMIN_PASSWORD.

[!NOTE] Ensure the binary has execute permissions (chmod +x komari). Data will be saved in the data folder in the running directory.

Manual Build

Dependencies

• Go 1.24+ and Node.js 20+ (for manual build)

1. Build the frontend static files:

   git clone https://github.com/komari-monitor/komari-web
   cd komari-web
   npm install
   npm run build
   

2. Build the backend:

   git clone https://github.com/komari-monitor/komari
   cd komari
   

   Copy the static files generated in step 1 to the /public/dist folder in the root of the komari project.

   go build -o komari
   

3. Run:

   ./komari server -l 0.0.0.0:25774
   

   The default listening port is 25774. Access http://localhost:25774.

Frontend Development Guide

Komari Theme Development Guide | Komari (https://komari-document.pages.dev/dev/theme.html)

Client Agent Development Guide

Komari Agent Information Reporting and Event Handling Documentation (https://komari-document.pages.dev/dev/agent.html)

Contributing

Issues and Pull Requests are welcome!

Acknowledgements

DreamCloud

DreamCloud - 极高性价比解锁直连亚太高防 (https://as211392.com/)

🚀 Sponsored by SharonNetworks

Sharon Networks (https://raw.githubusercontent.com/komari-monitor/public/refs/heads/main/images/sharon-networks.webp)

SharonNetworks 为您的业务起飞保驾护航！

亚太数据中心提供顶级的中国优化网络接入 · 低延时&高带宽&提供 Tbps 级本地清洗高防服务, 为您的业务保驾护航, 为您的客户提供极致体验. 加入社区 Telegram 群组 (https://t.me/SharonNetwork) 可参与公益募捐或群内抽奖免费使用

The open source software community

All the developers who submitted PRs and created themes

Star History

Star History Chart (https://api.star-history.com/svg?repos=komari-monitor/komari&type=Date)