# Red Kite Agent

Red Kite Agent is a self-hosted monitoring agent for Unraid that keeps your Red Kite hub aware each machine is alive and quietly healthy. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3266/red-kite-agent

## Description

Red Kite Agent is a self-hosted monitoring agent for Unraid that keeps your Red Kite hub aware each machine is alive and quietly healthy. Every few minutes it sends a heartbeat so the alarm is the absence of a message, not the presence of one, which means a server that loses power, loses its line, or is switched off is noticed without any inbound firewall ports being opened. It also reports issues that are easy to miss: parity sync errors, a disabled disk being emulated from parity, climbing SMART attributes, filesystems remounted read-only, and memory errors the machine corrects without saying so. Checks leave sleeping disks alone (SMART reads use standby mode and temperatures come from Unraid's cached figures), making it suited to homelab and NAS setups where you want monitoring that does not wake a spun-down array.

## Platform availability

Available on 1 of 6 install platforms: Unraid.

## Health score

42/100 (Fair), based on 3 of 4 factors.
- Maintained: 72 (last commit 24 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/redkite-agent-1b4gh5b1wpptbn?q=redkite-agent
- Official website: https://redkite.info
- GitHub: https://github.com/redkite-info/redkite-agent

## Common questions

### Do I need to open inbound ports, a VPN, or port forwarding for Unraid?

No; the agent only sends outbound heartbeats to the hub, so nothing connects inwards.

### Do I need to install or configure a Red Kite hub before the Unraid agent works?

Yes. You must install and run the self-hosted hub first; there is no hosted service or account.

### Can the hub send the agent commands or tell it to run code?

No. The agent's only network action is an outbound check-in, and the reply may carry only a bounded suggested interval and a replacement token.

### Does the agent send file names, process names, logs, or drive serial numbers?

No. It sends figures only, not file names, user names, process command lines, log message text, or drive serial numbers.

### Why does the Unraid agent container run as root?

The container runs as root because SMART reads use an ioctl that requires CAP_SYS_RAWIO. Everything the container can reach is mounted read-only, and it holds no capability that was not explicitly given.

### Why is there no Docker HEALTHCHECK?

The Dockerfile intentionally has no HEALTHCHECK. The hub is the healthcheck.

## Alternatives

- Anytxt Desktop Search
- DocFetcher: DocFetcher is an Open Source desktop search application: It allows you to search the contents of files on your computer.
- Everything: Locate files and folders by filename on Windows instantly, displaying all items on NTFS volumes and mapped network drives.
- FSearch: FSearch is a fast file search utility for GNU/Linux operating systems, inspired by Everything Search Engine.
- FileLocator
- Hister: Your own search engine
- SearchMyFiles: SearchMyFiles is a non-indexing portable alternative to the standard &quot;Search For Files And Folders&quot; module of Windows.
- agent: Agent is a private personal assistant you run on your own hardware.
- grep
- ripgrep

---
Source: Our Local Host (https://ourlocalhost.com/app/3266/red-kite-agent), the self-hosted and open-source app directory.
