Flotilla Agent sends the notifications from your Unraid server to your iPhone. The plugin has an MIT license. All of the server code is public on GitHub.

FUNCTION

The plugin installs as an Unraid notify agent. It sends the notifications that Unraid makes. These include parity checks, disk errors, SMART warnings and array events. Your User Scripts can also send notifications with the notify command.

The plugin sends a heartbeat signal at regular intervals. Then your phone can show the difference between a correct server and a server that is not on the network.

The plugin also runs three server checks: mover schedule, share free space, and disk load cycles. A problem creates an Unraid notification. The checks read only saved status files, and they do not wake disks. To stop the checks, set Run server checks to No.

The settings page is at Settings > Flotilla Agent. You pair the phone with a QR code.

SECURITY

The plugin operates as the root user. Read this section before you install it.

The plugin encrypts the content of each event on your server with ChaCha20-Poly1305. The encryption occurs before the data goes out of your local network. The key is in two locations only: the configuration file on your server, and the keychain on the paired phone. The plugin does not send the key to the relay. The plugin does not write the key to a log file.

The relay sends the push message to Apple. The relay receives ciphertext and a pairing identifier. The relay cannot read the text of your notifications. Apple also cannot read the text.

The plugin does not send your Unraid API key, your host name, or other local secrets.

The relay code is also public. The file PROTOCOL.md gives the data format. You can examine the code and make sure that these statements are correct.

COST

The plugin is free and open source.

The push messages go to Flotilla. Flotilla is my iOS app for Unraid and Proxmox. The push function needs the Pro option in that app. The Pro option costs USD 4.99 one time.

I give you this information now, and not after you install the plugin.

REQUIREMENTS

Unraid 7.0 or later

An iPhone with the Flotilla app

INSTALLATION

Install the plugin from Community Applications. Search for Flotilla Agent. You can also put this URL in Plugins > Install Plugin:

https://raw.githubusercontent.com/Livin21/flotilla-agent/main/plugin/flotilla-agent.plg

SOURCE CODE

Plugin, Proxmox beacon and encryption tool: https://github.com/Livin21/flotilla-agent

Relay: https://github.com/Livin21/flotilla-relay

LIMITS

The app operates on iOS only. There is no Android app.

I operate the relay. The relay keeps no data and reads no plaintext. But it is a dependency.

When you remove the plugin, it also removes the notify agent, the cron entries, the pairing and the saved check state. The relay URL, the filter settings and the server checks setting stay in /boot/config/plugins/flotilla-agent.

Send your questions and your problem reports to this topic. The plugin is new. I want to know about the problems that you find.

Edited November 5Nov 5 by livin21
Version 2026.11.05: server checks. The plugin is now in Community Applications.

Version 2026.11.05 is available. It adds three server checks: mover schedule, share free space, and disk load cycles. A problem creates an Unraid notification. The checks read only saved status files, and they do not wake disks. The checks are on by default. To stop them, open Settings > Flotilla Agent, set Run server checks to No, and click Save. To update, open the Plugins page and click Check for Updates.