Phone Home
Overview
MaestroHub includes an optional telemetry system called "Phone Home" that collects anonymous usage statistics to help us improve the platform. This page explains what data we collect, why we collect it, and how you can control it.
Privacy First
- No sensitive data - We never collect passwords, API keys, or workflow content
- Anonymous location data - Geographic information is derived from public IP and is approximate (city-level, not exact location)
- Transparent - All collected data is documented on this page
- Full control - You can disable telemetry at any time
What Data We Collect
1. System Information
Why: Understand deployment environments and compatibility needs
| Field | Description |
|---|---|
| License ID | Unique identifier for the license key |
| Version | MaestroHub Version |
| Hostname | Server hostname |
| Operating System | OS type |
| Architecture | CPU architecture |
| Public IP | Public IP address of the server |
| User Email | Email address of the user registered in the MaestroHub application |
2. Geographic Information
Why: Understand global distribution and provide region-specific improvements
| Field | Description |
|---|---|
| Country | Country name |
| City | City name |
| Region | State/province name |
| ISP | Internet Service Provider |
Geographic information is derived from your server's public IP address using ip-api.com service. This information is approximate and is used solely for understanding the global distribution of MaestroHub installations. No personally identifiable information is collected.
3. Usage Statistics
Why: Understand how features are being used to prioritize improvements
| Metric | Description |
|---|---|
| Total Connections | Number of configured connections |
| Connections by Type | Breakdown by connection type (PostgreSQL, REST API, MQTT, etc.) |
| Total Nodes | Count of all pipeline nodes |
| Nodes by Type | Detailed breakdown (e.g., trigger.manual, action.http) |
| Total Pipelines | Count of all pipelines |
| Enabled Pipelines | Count of currently running pipelines |
| Pipeline Executions - Total Runs | Total number of pipeline executions since startup |
| Pipeline Executions - Total Success | Number of successful executions |
| Pipeline Executions - Total Errors | Number of failed executions |
| Pipeline Executions - Success Rate | Overall success rate (0.0 to 1.0) |
| Pipeline Executions - Avg Duration | Average execution duration in milliseconds |
| Pipeline Executions - Currently Running | Number of pipelines currently executing |
| Pipeline Executions - Queued | Number of pipelines waiting in queue |
| Pipeline Executions - Runs Per Second | Average pipeline executions per second |
| Models | Number of data models defined |
Reporting Frequency
Usage reports are automatically sent at the following times:
On Startup
An initial usage report is sent when the MaestroHub application starts.
On First Admin Creation
When the first administrator user is created during initial setup, an immediate usage report is triggered. This helps track successful installations and onboarding.
Every Hour
After the initial startup report, usage statistics are automatically sent every 60 minutes.
Configuration
Enable or Disable Phone Home
Phone Home is enabled by default to help us improve MaestroHub. You can disable it at any time by setting the MAESTROHUB_PROFILES_LITE_PHONEHOME_ENABLED environment variable to false.
Windows:
setx MAESTROHUB_PROFILES_LITE_PHONEHOME_ENABLED false
macOS / Linux:
export MAESTROHUB_PROFILES_LITE_PHONEHOME_ENABLED=false
After setting the environment variable, run the launcher from the same terminal session. To re-enable Phone Home, set the variable to true or unset it.