jordaneunson / munkireport-rustdesk
MunkiReport module for collecting RustDesk remote desktop client configuration data from macOS endpoints
Package info
github.com/jordaneunson/munkireport-rustdesk
Type:munkireport-module
pkg:composer/jordaneunson/munkireport-rustdesk
Requires
- php: >=7.4
README
A MunkiReport module that collects RustDesk remote desktop client configuration data from macOS endpoints.
Overview
This module enables MSPs and IT administrators to track RustDesk client deployments across their fleet. Instead of manually documenting RustDesk IDs, this module automatically reports them to MunkiReport alongside other machine data.
Data Collected
| Field | Description |
|---|---|
| RustDesk ID | The unique 9-digit identifier for the client |
| Relay Server | The configured rendezvous/relay server |
| Key | The public key for server authentication |
| Version | Installed RustDesk application version |
| Permanent Password Set | Whether unattended access is configured |
| Alias | Custom friendly name if configured |
Requirements
- MunkiReport v5.x
- RustDesk client installed on endpoints
- macOS endpoints
Installation
-
Clone this repository into your MunkiReport
local/modules/directory:cd /path/to/munkireport/local/modules git clone https://github.com/jordaneunson/munkireport-rustdesk.git rustdesk -
Run database migrations:
cd /path/to/munkireport ./please migrate -
Add
rustdeskto yourMODULESconfiguration in.envorconfig.php -
Deploy the module to clients via Munki
Usage
Once deployed, the module will:
- Appear as a tab on individual machine detail pages
- Provide a listing view at
/show/listing/rustdesk - Allow filtering/searching by RustDesk ID, relay server, version, etc.
Configuration Files
The module reads from these RustDesk configuration locations on macOS:
~/Library/Preferences/com.carriez.rustdesk/RustDesk2.toml- Server settings~/Library/Preferences/com.carriez.rustdesk/RustDesk.toml- Client settings
License
MIT