Skip to content

gusinfosec/n8n-disk-sentinel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

n8n-Disk Sentinel Logo

n8n-Disk Sentinel

A lightweight n8n automation to monitor Linux disk space and send ntfy alerts when a critical threshold is exceeded.

Support me on Ko-fi

GitHub Stars Built for Linux


Nodes (high level): Manual Trigger → Exec df → Function (parse/format) → IF threshold → HTTP ntfy Alert + HTTP ntfy Report.

What it does

  • Runs df -P -B1 --output=source,fstype,size,used,avail,pcent,target.
  • Filters out virtual filesystems (tmpfs, devtmpfs, squashfs, overlay).
  • Calculates free percentage and builds a compact Markdown table (GiB/TiB).
  • Sends:
    • Report: a readable Markdown report to your ntfy topic.
    • Alert: when any mount’s free % is below a threshold (default in the Function node logic).

Repo layout

n8n-disk-check-glaciar-public/
├─ workflows/
│  └─ disk_check_FULL.json
├─ scripts/
│  └─ import.sh
├─ LICENSE
├─ .gitignore
└─ README.md

Import into n8n

UI

  1. n8n → WorkflowsImport from File.
  2. Choose workflows/disk_check_FULL.json.
  3. Open the workflow and update:
    • ntfy topic URL (use your own, e.g., https://ntfy.sh/<your-topic>).
    • (Optional) Replace Manual Trigger with a Cron node for your schedule.

CLI (optional)

# from repo root
./scripts/import.sh

Customize

  • Threshold: In the Function node, change the comparison (example):
    overallLow = vols.some(v => v.freePct < <THRESHOLD>);
  • Ignore list: Adjust tmpfs, devtmpfs, squashfs, overlay to your needs.
  • Timezone: Set the workflow timezone to match your environment.
  • ntfy topic: Replace https://ntfy.sh/<your-topic> with your topic or self‑hosted instance.

Security notes

  • The Exec node runs a shell command; deploy only on trusted n8n workers.
  • If your ntfy server is private, add Authorization in the HTTP nodes.

GitHub Quick start

Choose HTTPS or SSH.

HTTPS (use a Personal Access Token when prompted):

git init
git add .
git commit -m "feat: n8n disk check workflow with ntfy alerts"
git branch -M main
git remote add origin https://github.com/<your-username>/n8n-disk-check-glaciar.git
git push -u origin main

SSH alternative

git init
git add .
git commit -m "feat: n8n disk check workflow with ntfy alerts"
git branch -M main
git remote add origin [email protected]:<your-username>/n8n-disk-check-glaciar.git
git push -u origin main

Built from the provided workflow JSON. See workflows/disk_check_FULL.json.

About

n8n workflow that monitors filesystem usage with df, filters noise, and posts Markdown reports and low-space ntfy alerts for proactive disk monitoring.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages