[Insights](/insights/) / [OpenSource Contributions](/insights/opensource/)

# Critical server alerts with HotHost: open-source quick-to-setup Disk/RAM notifier

Learn about truly simple way to setup server critical monitoring. This is step-by-step guide to add Open-Source dockerized alerts to any linux server

![Ivan Borshchov](https://static.devforth.io/adminusers/avatars/2026/48db9847-d461-40cd-b344-f2bd7b0d98ca-avatar_ivan@devforth.io_f4ce9df9-8363-4314-9345-28753c76a386.jpeg)

Ivan Borshchov

CEO & System Architect @ Devforth

May 8, 2022

![Critical server alerts with HotHost: open-source quick-to-setup Disk/RAM notifier](https://static.devforth.io/posts/logo-svg/2026/6300194a-b8bf-4d6e-8048-6d1eb88fab9c-logo-preview-8a3bd7ec-ac1f-4cf3-9b43-8bd441f08183.svg)

![Critical server alerts with HotHost: open-source quick-to-setup Disk/RAM notifier](https://static.devforth.io/posts/logo-svg/2026/6300194a-b8bf-4d6e-8048-6d1eb88fab9c-logo-preview-8a3bd7ec-ac1f-4cf3-9b43-8bd441f08183.svg)

There are a lot of server monitoring tools on the market but most of them are pretty slow to setup or provide a lot of unneded metrics which are not so important and only unfocus attention.

When any tech business grows to some level it could allow to invest a couple dozen hours in reliable setup of standalone monitoring system like Netdata or Zabbix. Such setup requires a competent operations engineer with a specific skills. Software development agencies like Devforth could easily implement it because they regularly have some free capacity on experienced operations engineers, who do similar work over the years, but a lot of bootstraping enterpreneurs still think that they will save money if they hire one or two hardworking full-stack freelancers which might underestimate the need of monitoring. 

Anyway, for all projects on an early stages it is more important to reduce time-to-market and put all resources on features implementation. But if you are running software on VPS servers then you still need to be notified about upcoming critical issues on the live host which could be easily predicted, e.g. disk space is getting low or RAM memory is almost full.

So we think that someone might need simple enough tool to be installed anywhere by click of finger **with minumum effort** and notify about most critical issues only.

We implemented our PoC vision of monitoring simplicity in a free and open-source monitor called [HotHost](https://github.com/devforth/hothost):

![HotHost WebUI look](https://static.devforth.io/posts/images/2026/981f80a3-7dd4-4e05-97d2-d2582cea7de9-image.png)

HotHost WebUI look

Main features:

-   Get notified by Email/Slack/Telegram when host goes down or when available disk space / RAM is getting low.

-   Get notification when state is recovered

-   To set up the system, you need to run **HotHost Web** (docker container) on any host with public IP and setup SSL certificate. We will show simple steps on how to do it with CloudFlare and AWS EC2

-   To add a host under monitoring you have to click plus button on the web and copy a simple console command (docker CLI or compose) snippet and run it on a target host

-   In the end all monitoring components are self-hosted and free

-   You can add as many hosts under monitoring as you need to one HotHost Web instance.

-   On HotHost Web you can see generic info about hosts in one table: Hostname, public IP address, total and current number of RAM and Disk, processor model and a number of cores, swap size and whether it is enabled, the country where server is located.

-   You can use existing plugins as an example to quickly create a new plugins (e.g to send SMS notifications or push real-time hosts metrics to some BI service)

In the cheapest case agent and server could be installed on the same machine (self-monitoring). It also makes sense because you still will be able to receive notifications about the lack of resources on this server.

From a security aspect, an agent works in read-only mode and sends metrics by simple HTTPs protocol (though you can set up HTTP but it is not recommended). For every new agent, we generate a random secret and ship it in the snippet. This secret does not allow to forge the metrics. Authorization of user on HotHost Web is performed via login form which uses "Strict" Cookie.

### [](#step-by-step-installation-guide)**Step-by-step installation guide**

We will use AWS EC2 to launch a web however you can use any VPS with a public IP.

Login into AWS Console, go to **EC2** ➡️ **Instances** ➡️ **Launch an instance**, enter Name **hothost-web.**

1.  **Application and OS Images**: Select Ubuntu 22.04 or later
2.  **Instance type**: Smallest **t2.nano** instance would be enough.
3.  **Key pair**: Click **Create new key pair**. Save downloaded file because we will use it later to connect.

![Creating SSH Keypair](https://static.devforth.io/posts/images/2026/a5d2b2e3-6eab-4dc5-a74d-e2b0d9e41c73-JNvgbmH2DtspwMXNhHdZax.png)

Creating SSH Keypair

3. Under **Network settings** **(Click Edit**) disable IP address auto-assign (we will assign static Elastic IP later):

![Disable Auto-assign public IP](https://static.devforth.io/posts/images/2026/713a2c85-3ee0-4cce-acfa-8586e41c39d5-9XEjh5Mb7PMKpc2nXKmna3.png)

Disable Auto-assign public IP

Disable Auto-assign public IP

Also click **Add security group rule** and select **HTTP** to open port 80 in security groups:

![Open port 80](https://static.devforth.io/posts/images/2026/6a5963df-58f5-4b3d-9cd7-68255ae39519-Qfv4Z8DGnBKF6TTX2xMSWy.png)

Open port 80

4. Click Launch Instance

5.  Go to **EC2** → **Elastic IP addresses** **→ Allocate Elastic IP address**, then **Allocate**. Click on the checkbox on the left side of the IP item you've just created, and click on **Actions** → **Associate Elastic IP** address to associate the IP address to EC2 instance, select instance and confirm action.

Return to **EC2** → **Instances**, select instance and copy public IP address from Details tab:

![Public IP address](https://static.devforth.io/posts/images/2026/8a893c8d-669e-41ee-8251-ae1c22c6eb07-kcb7uShMwe5irnSLR7ouZ3.png)

Public IP address

> ⚠️ Never share this IP to anyone, we will hide it using Cloudflare later. I will destroy this IP forever before publishing post

6. Go to any bash console (use WSL 2 on Windows) and execute SSH command passing key which you donwloaded above:

```bash
ssh -i ~/hothost-web-key.pem ubuntu@3.72.209.62
```

7\. Edit hostname:

```bash
sudo nano /etc/hostname
```

Enter some\*\* \*\*clear name, for example **hothost-web**, save file by Ctrl+X

8. Now let's install docker to our host:

```bash
sudo apt update && sudo apt install -y docker.io
```

9. Now run next command which starts docker container:

```bash
sudo docker run -d --name=hothost-web \
  -v /www/hothostdata:/var/lib/hothost/data/ \
  --env HOTHOST_WEB_ADMIN_USERNAME=admin \
  --env HOTHOST_WEB_ADMIN_PASSWORD=theCoolVeryStroongPassword \
  --env HOTHOST_WEB_PORT=80 \
  --restart=always \
  -p 80:80 \
  devforth/hothost-web
```

If you wish, you can check status of started container by running:

```bash
sudo docker ps
```

Now it is time to connect [Cloudflare](https://www.cloudflare.com/) to terminate SSL (HTTPs) traffic. You can add an etire domain to Cloudflare or create subdomain on existing one. For example I have devforth.io added to Cloudflare so I will serve hothost on `https://hh.devforth.io`

![Add A record to Cloudflare domain](https://static.devforth.io/posts/images/2026/c14b26ad-ed9b-4f22-bc90-6d5b049d1e2e-5MMSN4BQn3Kp8y3FhTJ9rw.png)

Add A record to Cloudflare domain

Also make sure you are using **Flexible** SSL/TLS mode. You can check it in **SSL/TLS ➡️Overview**. This option enables user to use HTTPS to access hothost web (SSL is terminated on Cloudflare side) but Cloudflare will connect upstream using port 80 on which our docker container is listening.

![Flexible SSL/TLS in Cloudflare](https://static.devforth.io/posts/images/2026/0a3d48d0-bd87-4f5c-9761-0aa9f61e2523-eE4r7RuA2wzTEBmgBQbsmL.png)

Flexible SSL/TLS in Cloudflare

Also we recommed setting "Always Use HTTPS" to automatically redirect user from HTTP to HTTPS if they use it:

![Always Use HTTPS](https://static.devforth.io/posts/images/2026/a6914364-0229-4986-b9a5-a177125493d5-earZKSw8fG7A2y27E8PgXg.png)

Always Use HTTPS

> 📒 Please note, that if you are using Cloudflare on existing domain which also used to proxy traffic to other upstreams then last two options might create some incompatibilities with your existing upstreams. You can create some new domain or adjust your upstreams

You should see login form:

![HotHost login page](https://static.devforth.io/posts/images/2026/d93c2b23-ffb7-4e26-bc65-0603e141a695-RuudYV8SVKwsgDqc5amQUR.png)

HotHost login page

Enter your login and super strong password, you should get inside.

### [](#adding-an-agent)**Adding an agent**

Click **Add new host** button. You should instantly get fast code snippets:

![HotHost agent installation snippet](https://static.devforth.io/posts/images/2026/55f2bd91-4ee1-4fa1-b067-8a377f1964c7-GzFVYm6x2hEXC97w3UrCXX.png)

HotHost agent installation snippet

Let's use **Pure docker** to install agent on same host which runs server (self-monitoring). Just click **Copy**, and paste it into SSH console on same server. You might also need to add **sudo** if your docker is not configured for your user (Ctrl+A, type **sudo**)**.** After page refresh you should see host:

![Added host](https://static.devforth.io/posts/images/2026/57d56771-e5ad-4d13-b484-09dd4cc807c8-n4i3uDU9DmFZNipyDzzo9W.png)

Added host

### [](#setting-up-notifications)**Setting up notifications**

Go to **Settings**→**Plugins:**

![HotHost integrations page](https://static.devforth.io/posts/images/2026/939ac535-af12-486a-a0d4-1a4e3ce40951-6ApuvEfZbuRF6EHGwZV4fU.png)

HotHost integrations page

For example let's setup **Slack** notifications. Click On green **Enable** Button.

You will get detailed guide how to add Slack Webhook into your workspace:

![Configure HotHost SLack plugin](https://static.devforth.io/posts/images/2026/b33d40b9-1ec8-4835-a048-5033dc7c7042-JSQ7T7EhJZbbwZFmjP98NZ.png)

Configure HotHost SLack plugin

Fill **Webhook setting**, scroll down and click **Enable Plugin**.

To reproduce issue you can allocate some large file, e.g. I did **fallocate -l 5G file1**

And received next norification in Slack:

![HotHost Slack notification](https://static.devforth.io/posts/images/2026/be902fff-60c0-4c6b-9001-b996fba0ec54-4MTd3JCREJPKCCnoZ8JyxA.png)

HotHost Slack notification

After removing file you will get inverted "Ok" notification:

![Ok disk space notification](https://static.devforth.io/posts/images/2026/9473ccca-ed27-4c1c-b20e-b7e15898027b-8MVCHMrvtK5JAyEBPo389f.png)

Ok disk space notification

In same way you can add **Email** or **Telegram** notifications.

### [](#usefull-links)**Usefull links**

-   [HotHost on GitHub](https://github.com/devforth/hothost)

-   [How to create AWS account](https://hinty.io/devforth/how-to-create-an-aws-account/)

-   [How to add domain to Cloudflare](https://www.youtube.com/watch?v=7hY3gp_-9EU)

-   [Mail services](https://nodemailer.com/smtp/well-known/) supported by Email Plugin

[

Back to insights

](/insights)

[](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fdevforth.io%2Finsights%2Fcritical-server-alerts-with-hothost-open-source-quick-to-setup-diskram-notifier)[](https://bsky.app/intent/compose?text=Critical%20server%20alerts%20with%20HotHost%3A%20open-source%20quick-to-setup%20Disk%2FRAM%20notifier%0A%0Ahttps%3A%2F%2Fdevforth.io%2Finsights%2Fcritical-server-alerts-with-hothost-open-source-quick-to-setup-diskram-notifier)[](https://x.com/intent/tweet?text=Critical%20server%20alerts%20with%20HotHost%3A%20open-source%20quick-to-setup%20Disk%2FRAM%20notifier%20by%20%40ivanborshchov%0A%0Ahttps%3A%2F%2Fdevforth.io%2Finsights%2Fcritical-server-alerts-with-hothost-open-source-quick-to-setup-diskram-notifier)

[

Summarize with AI

](/lab/chat/?prompt=Extract%20main%20points%20from%20post%3A%20https%3A%2F%2Fdevforth.io%2Finsights%2Fcritical-server-alerts-with-hothost-open-source-quick-to-setup-diskram-notifier)

Table of Contents

-   [Step-by-step installation guide](#step-by-step-installation-guide)
-   [Adding an agent](#adding-an-agent)
-   [Setting up notifications](#setting-up-notifications)
-   [Usefull links](#usefull-links)

[](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fdevforth.io%2Finsights%2Fcritical-server-alerts-with-hothost-open-source-quick-to-setup-diskram-notifier)[](https://bsky.app/intent/compose?text=Critical%20server%20alerts%20with%20HotHost%3A%20open-source%20quick-to-setup%20Disk%2FRAM%20notifier%0A%0Ahttps%3A%2F%2Fdevforth.io%2Finsights%2Fcritical-server-alerts-with-hothost-open-source-quick-to-setup-diskram-notifier)[](https://x.com/intent/tweet?text=Critical%20server%20alerts%20with%20HotHost%3A%20open-source%20quick-to-setup%20Disk%2FRAM%20notifier%20by%20%40ivanborshchov%0A%0Ahttps%3A%2F%2Fdevforth.io%2Finsights%2Fcritical-server-alerts-with-hothost-open-source-quick-to-setup-diskram-notifier)
