# YunoHost Monitoring 101

**URL:** https://forum.yunohost.org/t/yunohost-monitoring-101/37183
**Category:** Discuss
**Tags:** vps, monitoring, english
**Created:** [June 6, 2025, 7:39am UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183 "2025-06-06T07:39:44Z")
**Posts on this page:** 20
**Page:** 1

<div class="post-metadata">

### Author: ![tommi](https://forum.yunohost.org/user_avatar/forum.yunohost.org/tommi/32/4537_2.png) [@tommi](https://forum.yunohost.org/u/tommi)
#### Post date: [June 6, 2025, 7:39am UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183/1 "2025-06-06T07:39:44Z")

</div>

Hi everyone!

I have been running a YunoHost server for ~5 years now, but there is one question I have never been able to reply to: **how loaded is my server?** 👀

I am a terrible administrator, I have no idea how to determine:

- if my server is running smoothly
- if the server is under stress, and why
- what applications are the heaviest
- if there is the possibility of installing more apps
- when peaks of stress are happening and what is causing them

In general, I would like to understand the fundamentals of **server monitoring** : what are **the most critical metrics** and what do they mean? What parameters do I have to keep an eye on?

I installed Prometheus and Grafana, but then I realized I have absolutely no idea what to do next… Do you have any suggestions?

I thought about watching some video tutorials, but I would not really know how they would relate to YunoHost installations.

Feel free to send me any resource that comes to your mind! Once I will have learned the basics, I would be very happy to write some pointers about this in the documentation, or an essential **YunoHost Monitoring tutorial**.

---

<div class="post-metadata">

### Author: ![tommi](https://forum.yunohost.org/user_avatar/forum.yunohost.org/tommi/32/4537_2.png) [@tommi](https://forum.yunohost.org/u/tommi)
#### Post date: [June 6, 2025, 7:48am UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183/2 "2025-06-06T07:48:22Z")

</div>

Cross-posted on the Fediverse for visibility. Boost this post if you have the same questions!

> **[Tommi 🤯 (@tommi@pan.rent)](https://pan.rent/@tommi/114635312015017584)**
>
> \# Server monitoring 101
> 
> I have been running a @yunohost@toot.aquilenet.fr server for ~5 years now, but there is one question I have never been able to answer: \*\*how loaded is my server?\*\* 👀
> 
> I know, I am a terrible sysad (actually, I am \*not\* a...

---

<div class="post-metadata">

### Author: ![Micha](https://forum.yunohost.org/letter_avatar_proxy/v4/letter/m/c37758/32.png) [@Micha](https://forum.yunohost.org/u/Micha)
#### Post date: [June 6, 2025, 9:04am UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183/3 "2025-06-06T09:04:13Z")

</div>

Hi,  
same here, i don’t really know how to monitor my little server. What i do is using htop, there you can see the load and ram usige. And sometimes not all services are running so i check `yunohost diagnosis show --issues` . On my old yunohost VPS with Debian11 i got email, when an issue was there.

---

<div class="post-metadata">

### Author: ![tommi](https://forum.yunohost.org/user_avatar/forum.yunohost.org/tommi/32/4537_2.png) [@tommi](https://forum.yunohost.org/u/tommi)
#### Post date: [June 6, 2025, 9:15am UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183/4 "2025-06-06T09:15:51Z")

</div>

My problem is not really what is not working, because indeed YunoHost’s own diagnosis works quite well. It’s more about what’s stressing/loading the hardware…

---

<div class="post-metadata">

### Author: ![esist0](https://forum.yunohost.org/user_avatar/forum.yunohost.org/esist0/32/10882_2.png) [@esist0](https://forum.yunohost.org/u/esist0)
#### Post date: [June 6, 2025, 10:27am UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183/5 "2025-06-06T10:27:37Z")

</div>

a little ui for fail2ban stuff and monitoring stuff linked to what’s using more cpu etc would be cool.

---

<div class="post-metadata">

### Author: ![digitales](https://forum.yunohost.org/letter_avatar_proxy/v4/letter/d/439d5e/32.png) [@digitales](https://forum.yunohost.org/u/digitales)
#### Post date: [June 6, 2025, 10:47am UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183/6 "2025-06-06T10:47:15Z")

</div>

I use Monitorix for that purpose. It displays lots of graphs and allows you to select the time period. I haven’t yet configured it to send me emails about critical issues. That would be the next step.

---

<div class="post-metadata">

### Author: ![jarod5001](https://forum.yunohost.org/user_avatar/forum.yunohost.org/jarod5001/32/5323_2.png) [@jarod5001](https://forum.yunohost.org/u/jarod5001)
#### Post date: [June 6, 2025, 11:29am UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183/7 "2025-06-06T11:29:09Z")

</div>

I generally have phpsysinfo, htop, btop, iotop, watchdog installed on my servers.  
I still didn’t find an easy way for log analysis and viewing logs on web interface. Some options are available on github but I didn’t find time to look at them.

---

<div class="post-metadata">

### Author: ![yekibud](https://forum.yunohost.org/user_avatar/forum.yunohost.org/yekibud/32/4925_2.png) [@yekibud](https://forum.yunohost.org/u/yekibud)
#### Post date: [June 7, 2025, 6:51pm UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183/8 "2025-06-07T18:51:05Z")

</div>

@tommi I finally got around to thinking about this myself the other day and tried out a few things that have been suggested. I started with Prometheus and Grafana - all you have to do is run the official node\_exporter metrics exporter on your machine and add the Grafana node\_exporter dashboard. This is the most powerful and complete system, which you can also wire up alerts for, but I found it to be overkill for my needs. Then I tried some of the other tools folks have already mentioned:

- Monitorix - provides a nice grab-bag of graphs out-of-the-box, but has an unusable UI, IMO
- PHPSysinfo - provides a nice/simple page with basic stats

I also tried Glances, but I didn’t see much benefit to that over shelling into my machine and running top, etc. NetData was a no-go because of the proprietary front-end.

Finally I realized what I really wanted was just basic alerting for memory and disk usage - which the YNH Diagnosis tool already provices 🤦‍♂️ While it’s true this only provides memory stress alerting at the time the diagnosis is run and doesn’t account for memory spikes, CPU or disk/network I/O, I’ve found the only thing that’s really caused issues with my YNH instance and apps over the past 6 years is memory and disk space.

That said, if you need more granularity for some reason, then I think Prometheus/Grafana is probably your best option - mostly because of the alerting component. Although I didn’t know you could configure email alerts for Monitorix - might take a second look at it, now that I know about that.

UPDATE: Meh, took a look at the Monitorix alerts - the docs are like the graphs, IMO - all over the place. Lots of noise that I think most people don’t need, and if I’m going to be configuring scripts for each built-in graph to send alerts, then I may as well configure Prometheus Alertmanager or Grafana alerting. If anyone knows any other monitoring tools with a simple and sensible alerting setup, I’d love to know.

---

<div class="post-metadata">

### Author: ![tzb6js](https://forum.yunohost.org/user_avatar/forum.yunohost.org/tzb6js/32/11899_2.png) [@tzb6js](https://forum.yunohost.org/u/tzb6js)
#### Post date: [June 7, 2025, 9:18pm UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183/9 "2025-06-07T21:18:54Z")

</div>

As a newbie I may be missing the point here but I use the Cockpit app to see how much memory is being used, how much swap is available, what process load is like and which apps are soaking up both. It seems like a simple easy to use tool to me. What more do you need or importantly what am i missing?

---

<div class="post-metadata">

### Author: ![yekibud](https://forum.yunohost.org/user_avatar/forum.yunohost.org/yekibud/32/4925_2.png) [@yekibud](https://forum.yunohost.org/u/yekibud)
#### Post date: [June 8, 2025, 12:48am UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183/10 "2025-06-08T00:48:09Z")

</div>

@tzb6js Cockpit looks interesting, love that it’s written in Python - but one thing it at least doesn’t seem to cover is alerting, which I find pretty critical for monitoring. Not sure if that’s a priority for the OP, though. (Oh, and it looks like Cockpit wont run out of the box on YNH if you’re also running Jitsi because they compete for port 9090)

---

<div class="post-metadata">

### Author: ![cichy1173](https://forum.yunohost.org/user_avatar/forum.yunohost.org/cichy1173/32/9993_2.png) [@cichy1173](https://forum.yunohost.org/u/cichy1173)
#### Post date: [June 8, 2025, 7:11pm UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183/11 "2025-06-08T19:11:14Z")

</div>

I use Beszel for monitoring and alerting (alerts are being send to me via Telegram). Also I use Uptime Kuma to have some kind of healthcheck (Uptime Kuma also sends alerts via Telegram).  
Important note here is that I host Beszel Server and Uptime Kuma on external VPS which is connected with my Yunohost box via Tailscale (Uptime Kuma just pings the web services, but Beszel needs beszel-agent installed on Yunohost box).

---

<div class="post-metadata">

### Author: ![Jerry19](https://forum.yunohost.org/letter_avatar_proxy/v4/letter/j/3d9bf3/32.png) [@Jerry19](https://forum.yunohost.org/u/Jerry19)
#### Post date: [June 11, 2025, 8:02pm UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183/12 "2025-06-11T20:02:42Z")

</div>

I use Webadmin, this seems to provide all the info that I needed on the health of my server. It also provides me with UI to navigate my Yunohost server internal file structure and installed apps.

---

<div class="post-metadata">

### Author: ![hook](https://forum.yunohost.org/user_avatar/forum.yunohost.org/hook/32/8965_2.png) [@hook](https://forum.yunohost.org/u/hook)
#### Post date: [June 21, 2025, 1:49pm UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183/13 "2025-06-21T13:49:58Z")

</div>

> [@esist0](#):
>
> fail

You mean like [YunoHost app store | Fail2Ban Webinterface](https://apps.yunohost.org/app/fail2ban-web) – or is this missing things you need?

---

<div class="post-metadata">

### Author: ![hook](https://forum.yunohost.org/user_avatar/forum.yunohost.org/hook/32/8965_2.png) [@hook](https://forum.yunohost.org/u/hook)
#### Post date: [June 21, 2025, 3:09pm UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183/14 "2025-06-21T15:09:32Z")

</div>

One thing I’m concerned about is to figure out what is the impact of AI (and other) crawler bots on my server’s resources.

How can I tell what is legitimate traffic and what is hammering I want to block/ban. How can I block/ban that after I’ve found it? Is Fail2Ban enough here?

As @tommi implied: what good are numbers and graphs without the context knowledge that a less-experienced – e.g. I’ve been self-hosting for decades now, but I’m still not much of a SysAdmin IMHO – YunoHost admin would simply not have (yet).

Some noobie-friendly guides would be more than welcome. And thank you, @tommi , for both bringing this up and volunteering to kick-start the documentation effort. I’m happy to contribute in what little I can.

---

<div class="post-metadata">

### Author: ![Lapineige](https://forum.yunohost.org/letter_avatar_proxy/v4/letter/l/bc79bd/32.png) [@Lapineige](https://forum.yunohost.org/u/Lapineige)
#### Post date: [June 21, 2025, 7:54pm UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183/15 "2025-06-21T19:54:01Z")

</div>

> [@hook](#):
>
> How can I block/ban that after I’ve found it? Is Fail2Ban enough here?

You may check out the Anubis app

---

<div class="post-metadata">

### Author: ![hook](https://forum.yunohost.org/user_avatar/forum.yunohost.org/hook/32/8965_2.png) [@hook](https://forum.yunohost.org/u/hook)
#### Post date: [June 21, 2025, 8:11pm UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183/16 "2025-06-21T20:11:37Z")

</div>

I know about Anubis and its ilk. I’m just unsure if I need it. And since it does make everyone’s lives a bit harder (and wastes their resources a bit), I would much prefer not deploying it preemptively.

Also Anubis probably does not protect me from an angry script kiddie or a different (D)DoS.

---

<div class="post-metadata">

### Author: ![yolateng0](https://forum.yunohost.org/user_avatar/forum.yunohost.org/yolateng0/32/163_2.png) [@yolateng0](https://forum.yunohost.org/u/yolateng0)
#### Post date: [June 22, 2025, 8:35am UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183/17 "2025-06-22T08:35:51Z")

</div>

hi  
I use Server box, user-friendly with no extension on server.  
Serverbox is a versatile, open-source application designed for Android devices, offering users a powerful tool to manage and monitor servers directly from their mobile devices. This innovative software provides a comprehensive suite of features tailored for system administrators, developers, and IT professionals who require on-the-go access to their server infrastructure.

> **[ServerBox | F-Droid - Free and Open Source Android App Repository](https://f-droid.org/packages/tech.lolli.toolbox/)**
>
> A server status & toolbox app using Flutter

Key Features:

1. **Remote Server Management** : Serverbox allows users to connect to and manage remote servers securely. Whether you need to execute commands, monitor server performance, or manage files, Serverbox provides an intuitive interface to handle these tasks efficiently.

2. **Multi-Protocol Support** : The application supports various protocols, including SSH, FTP, and SFTP, ensuring compatibility with a wide range of server configurations. This multi-protocol support enables seamless integration with existing systems and workflows.

3. **User-Friendly Interface** : Designed with usability in mind, Serverbox features a clean and intuitive interface that simplifies complex server management tasks. The user-friendly design ensures that both novice and experienced users can navigate the application with ease.

4. **Security** : Security is a top priority for Serverbox. The application employs robust encryption and authentication mechanisms to protect sensitive data and ensure secure communications between the mobile device and the server.

5. **Customization and Extensibility** : Serverbox offers extensive customization options, allowing users to tailor the application to their specific needs. Additionally, its open-source nature encourages community contributions, fostering continuous improvement and innovation.

6. **Real-Time Monitoring** : With Serverbox, users can monitor server performance in real-time, receiving alerts and notifications for critical events. This feature enables proactive management and quick response to potential issues, minimizing downtime and enhancing reliability.

Serverbox is an invaluable tool for anyone involved in server management, providing the flexibility and functionality needed to maintain optimal server performance from anywhere, at any time. Its open-source license ensures that users can benefit from a transparent, community-driven development process, making it a trusted choice for mobile server management.  
Sources: F-droid

---

<div class="post-metadata">

### Author: ![chateau](https://forum.yunohost.org/user_avatar/forum.yunohost.org/chateau/32/1865_2.png) [@chateau](https://forum.yunohost.org/u/chateau)
#### Post date: [June 22, 2025, 11:22am UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183/18 "2025-06-22T11:22:56Z")

</div>

Thanks @tommi for starting this thread. I was looking into this subject at this very time and all responses given here have been extremely useful to me to weight different options. Also thanks in particular @yekibud for your comments, I found them very useful.

I’ll summarize here what I’ve found, maybe it can be of some use for others, please note that I haven’t tested most of those things, I only gathered them from this thread and other sources:

## Nice tools for a quick, extensive and readable instantaneous screenshot of your server:

They are convenient display of what’s happening at that moment, but not over time.

| name | cli/webinterface | has ynh package | comments |
| --- | --- | --- | --- |
| [phpsysinfo](https://phpsysinfo.github.io/phpsysinfo/) | webpage | [yes](https://github.com/YunoHost-Apps/phpsysinfo_ynh) | Summary of many info on your server. |
| htop | cli | no\[1\] | View current usage of cpu, load, ram, processes… |
| btop | cli | no\[1:1\] | View “usage and stats”. |
| iotop | cli | no\[1:2\] | I/O live monitoring. |
| [glances](https://nicolargo.github.io/glances/) | cli | [yes](https://github.com/YunoHost-Apps/glances_ynh) | Very comprehensive display of many things going on in your server in one single terminal view. |
| [goaccess](https://goaccess.io/) | cli + web interface | no | Real-time web log analyzer. |

## Utilities

| name | has ynh package | description |
| --- | --- | --- |
| [watchdog](https://sourceforge.net/projects/watchdog/) | [yes](https://github.com/YunoHost-Apps/watchdog_ynh) | Automatically reboot server if necessary when something goes wrong. |
| [fail2ban webinterface](https://github.com/ewilly/fail2ban-web-interface-php) | [yes](https://github.com/YunoHost-Apps/fail2ban-web_ynh) | Configure fail2ban through a web interface. |
| [cronicle](https://github.com/jhuckaby/Cronicle) | no | Multi-server task scheduler and runner, with a web based front-end UI. |

## Monitoring over time and alerting

| name | alerts | has ynh package | comments |
| --- | --- | --- | --- |
| [prometheus](https://prometheus.io/) | yes | [yes](https://github.com/YunoHost-Apps/prometheus_ynh) | Very comprehensive monitoring tool, but probably most useful used with grafana. So will require some work to set up. |
| [grafana](https://grafana.com/) | yes\[2\] | [yes](https://github.com/YunoHost-Apps/grafana_ynh) | Very comprehensive monitoring tool, but requires most probably quite a bit of time to setup, to connect it with other elements like prometheus or others. If one wants to use netdata as well, maybe the yunohost package works out of the box though. |
| [beszel](https://beszel.dev/) | yes | no | Seems like a comprehensive monitoring tool. Unfortunately not yet packaged for yunohost. |
| [uptime kuma](https://uptime.kuma.pet/) | yes | [yes](https://github.com/YunoHost-Apps/uptime-kuma_ynh) | Verify availability of services. Alert when they are down. |
| [webmin](https://webmin.com/) | ? | [yes](https://github.com/YunoHost-Apps/webmin_ynh) | Server admin interface, with a really impressive amount of features. Very useful to learn about many settings one has to handle in a server. But that’s giving lots of powers to a webui, and the secuity risks that goes with it. |
| [cockpit](https://cockpit-project.org/) | no | [yes](https://github.com/YunoHost-Apps/cockpit_ynh) | Server admin interface, didn’t explore it more as it doesn’t seem to have alerting system. |
| [monitorix](https://www.monitorix.org/) | yes | [yes](https://github.com/YunoHost-Apps/monitorix_ynh) | Very comprehensive monitoring tool. Works out of the box with the yunohost package, and very easy to configure graph reports and alerts on some stats through the yunohost admin panel. |
| [munin](https://munin-monitoring.org/) | yes | [no it’s outdated](https://github.com/YunoHost-Apps/munin_ynh) | Very comprehensive monitoring tool: “Designed to be very plug and play, a default installation provides a lot of graphs with almost no work.” Unfortunately the yunohost package is not maintained anymore. |
| [netdata](https://www.netdata.cloud/) | yes | [yes](https://github.com/YunoHost-Apps/netdata_ynh) | Seems very comprehensive as well but many many reports that says it uses to much resources. |
| [zabbix](https://www.zabbix.com/) | yes | [yes](https://github.com/YunoHost-Apps/Zabbix_ynh) | Their website is very corporate, but it seems like probably it can do everything one can hope to do with monitoring. Don’t know how easy for small setups like yunohost. |
| [LibreNMS](https://www.librenms.org/) | yes | no | Like their website say: “a fully featured network monitoring system that provides a wealth of features”. Testing it with their demo site, it seems the interface is quite complex though for beginners, so will require a bit of time to learn to use it. |

## Conclusions

In the end I decided to try using monitorix. Hope it’ll be a good choice over time. But to answer a bit to @yekibud’s critics to it, the yunohost package makes a great job at having it working out of the box, and configuring it for reports.  
The monitorix yunohost admin panel also makes it easy to configure alerts for a few parameters without having to script anything. And to have more out-of-the-box alerting available for all yunohost users requires just one person to take the time to create those config scripts and propose them to the monitorix\_ynh repo.

Thanks everyone for your suggestions. Please feel welcome to correct me for anything I’ve gotten wrong.  
And @tommi or others, if you want to use this as a basis for the documentation page on monitoring you were thinking of, feel free to do so 🙂

EDIT1: Added goaccess, zabbix and LibreNMS after discovering [this old similar thread](https://forum.yunohost.org/t/which-monitoring-software-for-a-herd-of-yunohosts/18259/8).  
EDIT2: Added cronicle.

* * *

1. Well htop, btop and iotop don’t have a yunohost package, but they don’t really need one because it’s enough to run `apt install htop btop iotop` to install and have then working. 

2. The grafana yunohost package seem to clearly expect to be linked to netdata. So I don’t know how useful it is out of the box without netdata, and how convenient it is to set it up to use other monitoring data sources.

---

<div class="post-metadata">

### Author: ![arnauld](https://forum.yunohost.org/user_avatar/forum.yunohost.org/arnauld/32/12085_2.png) [@arnauld](https://forum.yunohost.org/u/arnauld)
#### Post date: [June 22, 2025, 1:00pm UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183/19 "2025-06-22T13:00:03Z")

</div>

Thank you for this list. I am tempted to install watchdog on my Pi, however it specifies:

> It better (only?) works if your server has a [hardware watchdog device](https://en.wikipedia.org/wiki/Watchdog_timer).

So, do I have to install a hardware watchdog device?

---

<div class="post-metadata">

### Author: ![yekibud](https://forum.yunohost.org/user_avatar/forum.yunohost.org/yekibud/32/4925_2.png) [@yekibud](https://forum.yunohost.org/u/yekibud)
#### Post date: [June 23, 2025, 5:51pm UTC](https://forum.yunohost.org/t/yunohost-monitoring-101/37183/20 "2025-06-23T17:51:45Z")

</div>

Oh, didn’t even see the YNH Admin GUI for Monitorix - thanks for pointing that out @chateau ! I’ll give it another try.

[Next page](https://forum.yunohost.org/t/yunohost-monitoring-101/37183.md?page=2)
