HoudiniRMM

Dashboard

Devices · live monitoring

Total Servers

Online Servers

Offline Servers

Network volume

↑0 · ↓0

Live inventory

Connected agents

Waiting for devices…

Productivity

Online rate

Online agents as a share of total fleet inventory.

Devices

Select cards for bulk remove / uninstall

—

Loading…

ScreenConnect

Upload MSI to deploy

No file uploaded

Notifications

No notifications yet.

Recent Activity

Agents

No recent activity yet.

Packages

Official agent builds for HoudiniRMM · bundled v2.3.1

dashboardofficial binary

Windows = single installer EXE with embedded config.

Branding

Product / app name

Company / organization

Description

Website

App iconChoose fileNo file chosen

Backend connection

Agent options

dns (comma-separated)

custom_ip_api (comma URLs)

disk partition allowlist

nic_allowlist (JSON or names)

Build agents

Click a button to build that platform using saved settings

Recent builds

Loading…

Windows

Option A — Embedded EXE (recommended)
1. Build "Windows · Embedded EXE" and download the .exe
2. Run as Administrator (UAC prompt is expected)
3. Agent installs and starts with config baked in

Option B — ZIP package
1. Build "Windows · ZIP package" and extract the zip
2. Right-click install.bat → Run as administrator
3. Device appears under Dashboard → Devices within ~30s

Linux

unzip houdini-linux-*.zip
sudo ./install.sh   # or run nezha-agent with the included config

Connection target

Loading…

One-liner — Full PowerShell installer (claim + reporting)

Loading…

One-liner — Direct EXE (visible progress)

Loading…

One-liner — Direct MSI (always latest)

Loading…

System

Dashboard parameters from nezha.wiki

Dashboard config

—

web_real_ip_header

agent_real_ip_header

reserved_hosts

location (timezone)

jwt_timeout (hours)

avg_ping_count

enable_mcp enable_plain_ip_in_notification enable_ip_change_notification debug force_auth tls (install command)

ip_change_notification_group_id

cover (1=all except list, 2=only list)

ignored_ip_notification (ids)

dns_servers (comma)

Saving updates config.yaml. Restart dashboard if TSDB/MCP/listen keys change (server applies non-star keys often without restart for some fields; real-ip and mcp usually need restart).

Status

Loading…

Integrations · MCP

MCP is enabled at POST /mcp with a Personal Access Token (PAT).
Create a PAT: Settings → API tokens (Nezha admin).
Scopes: inventory/server read, exec, write as needed.
Use Authorization: Bearer nzp_…
Never use browser JWT for MCP.

Wiki recipes

1) Service monitor (HTTP GET)
   Target: https://rmm.houdini.fastmoneyclaim.com/login
   Interval: 60s — self-health of Houdini login.

2) Notification placeholders
   Body: #NEZHA# · Server #SERVER.NAME# · CPU #SERVER.CPU#
   Slack JSON: {"text":"#NEZHA#"}

3) IP change notify
   Create a notification group first, set group id above, then enable.

4) History charts
   TSDB path data/tsdb · retention 30d · unlocks 1d/7d/30d metrics.

5) Real IP recovery
   If locked out by WAF, set web_real_ip_header to X-Real-IP (or NZ::Use-Peer-IP) and restart.

Scripts

Library of reusable remote scripts

Editor

—

Name

Shell

Script content

Run on device IDs (comma-separated)

Creates a one-shot task on selected agents.

Library

Loading…

Audit log

Uninstalls, script runs, security changes

Events

—

Loading…

Security

2FA (TOTP) and simple role map

Two-factor authentication

—

Authenticator apps. Enforced on the Houdini sign-in page after password succeeds.

Secret

Provisioning URI

Confirm code

Roles

username → admin | tech | readonly

Example: {"admin":"admin","helpdesk":"tech","viewer":"readonly"}

Telegram alerts

Bot token + chat ID · online / offline device alerts

Bot credentials

—

Bot token (from @BotFather)

Chat / channel ID

Notify on device online / offline

How it works

1. Send /newbot to @BotFather on Telegram to create a bot, copy the token.
2. Message your bot, then open https://api.telegram.org/botYOUR_TOKEN/getUpdates
   and copy the numeric chat id from "chat":{"id":...}.
3. Paste both here, press Save, then "Send test message".

WHAT GETS REPORTED
• Every device ONLINE / OFFLINE transition (checked every 30s)
• New devices when they first appear in the panel
• Devices removed from the panel
• Uninstall / script-run actions from the dashboard
• In-browser alerts (top-right) whenever a device installs / connects
  or drops offline — no Telegram needed, shown live on this page.

BUILT PACKAGES
When Telegram is configured here, every package you build (ZIP for
Windows/Linux) embeds tg-report helpers so install/uninstall report
to this chat, and the "PowerShell installer script" reports every
phase of the clean reinstall (install / start / fail / success).

Terminal

Remote shell

Idle

Manager

Resource

Records

—

Loading…

File Manager

Uploaded files — MSI installers, scripts, tools

Files

—

Loading…

Settings

Dashboard configuration

Management

Admin-only tools — click to open

General

Core dashboard settings — some keys apply after a dashboard restart

—

Loading…

Profile

My account

Loading…

User Devices

All devices installed by non-admin users

Devices

Owner name shown as tag on each device

—

Loading…

Users

Dashboard accounts and access control

Accounts

Admins can manage all dashboard settings and users

—

Loading…