Skip to main content
Version: 2.0-beta.1

Getting Started

MaestroHub helps industrial teams connect disparate systems, model operations, and orchestrate real-time data pipelines. Use this guide to work through the practical setup steps: confirm prerequisites, install the platform, bring the MaestroHub UI online, and finish configuration with the in-app onboarding tour.

Begin with installation, then sign in to the MaestroHUB UI, and finally let the interactive onboarding guide you through building your first flow.

MaestroHub Launcher​

The MaestroHub Launcher is a single executable that bundles and runs all MaestroHub services with zero configuration required. The launcher automatically starts:

The launcher is currently available as a beta release for Windows, macOS, and Linux. As this is a beta version, we appreciate your understanding and patience as we continue to develop and improve the platform.

Windows Installation​

  1. Download the MaestroHub Launcher ZIP file for Windows.
  2. Extract the ZIP file to a folder of your choice.

After extraction, you'll see the following structure:

maestrohub-launcher/
├── README.txt
├── start-launcher.bat
└── bin/
    └── maestrohub-launcher.exe
  1. Double-click start-launcher.bat to launch MaestroHub.

A console window will appear showing the launcher starting all services. Once all services are running, your default browser will automatically open to http://localhost:23390 where you can sign in and start using MaestroHub.

macOS Installation​

  1. Download the MaestroHub Launcher archive for your Mac:
    • Intel Macs: maestrohub-launcher_*_darwin_amd64.tar.gz
    • Apple Silicon (M1/M2/M3): maestrohub-launcher_*_darwin_arm64.tar.gz
  2. Extract the archive: 
    tar -xzf maestrohub-launcher_*_darwin_*.tar.gz
  3. Run the launcher by double-clicking maestrohub-launcher or run this command in Terminal: 
    ./maestrohub-launcher

The launcher will start all services and automatically open the web UI in your default browser.

macOS Security Settings

If macOS blocks the launcher with a message that it "cannot be opened because it is from an unidentified developer," you need to allow it in your security settings:

  1. Go to System Settings (or System Preferences on older macOS) > Privacy & Security
  2. Scroll down to the Security section
  3. You'll see a message that MaestroHub Launcher was blocked
  4. Click Open Anyway and confirm

For more information, see Apple's guide on opening apps from unidentified developers.

Linux Installation​

  1. Download the MaestroHub Launcher archive: maestrohub-launcher_*_linux_amd64.tar.gz
  2. Extract the archive: 
    tar -xzf maestrohub-launcher_*_linux_amd64.tar.gz
  3. Run the launcher: 
    ./maestrohub-launcher

The launcher will start all services and automatically open the web UI in your default browser.

Running and Managing​

Once you run the launcher, it will:

  • Start all MaestroHub services automatically
  • Open the web UI at http://localhost:23390 in your default browser
  • Application data files, including logs, are stored in ~/maestrohub/ (under your home directory).
  • Display a tray icon in your system tray (Windows) or menu bar (macOS/Linux)
Tray icon menu

Shutting Down​

You can shut down MaestroHub using one of these methods:

  • Terminal: If you started the launcher from a terminal, press Ctrl+C (or Cmd+C on macOS) to initiate a graceful shutdown. The launcher waits up to 5 seconds for services to stop gracefully before forcing termination.
  • Tray Icon: Right-click the tray icon and select Shutdown to safely stop all services.

Troubleshooting​

  • Verify the launcher is running by checking the console window
  • Review logs for each run stored in ~/maestrohub/logs/ within your home directory. You can access them through the tray icon (Troubleshooting > Logs)
  • Ensure the required ports are not already in use and are not blocked by your firewall or antivirus software such as Windows Defender
  • If you want to restart the application with a data purge, you can clear the data directory ~/maestrohub

Build Your First Pipeline​

When MaestroHub is running, the launcher automatically opens the UI in your browser at http://localhost:23390.

When you start the launcher for the first time, you'll need to create an initial administrator account. After creating the initial account, you will be signed in automatically and redirected to the home page.

Create admin account form

Create your initial administrator account to get started with MaestroHub.

Once you're signed in, the interactive onboarding immediately begins, spotlighting each screen you need to configure. The guided tour walks you through building your first working data flow step-by-step, so you know exactly which fields to fill and where to click next.

Interactive onboarding overlay in MaestroHub

Onboarding overlays guide you through every configuration step inside the MaestroHub UI.

The tour is organized into guided checkpoints, each with inline tooltips and prompts that explain exactly what to enter before you can continue:

  1. Create Connection - learn how to connect to external REST APIs, configure authentication and base URLs, and test integrations before saving.
  2. Create Function - recap what you just learned by defining API endpoints, selecting HTTP methods, validating responses, and turning them into reusable calls.
  3. Create Data Model - reinforce consistent schemas by choosing field names, types, and validation rules that keep structures aligned.
  4. Create Function Instance - combine functions with data models to produce reusable pipeline components while validating data shapes.
  5. Build & Execute Pipeline - explore the visual designer, connect nodes into end-to-end workflows, fine-tune transformation logic, and run the pipeline while reviewing executions in the history view.

Every checkpoint validates the data you submit, highlights the UI elements to touch next, and provides a "Continue" cue that moves you forward only when the step is complete. Stick with the tour before exploring advanced screens to ensure every dependency is configured correctly.

Core capabilities to explore next​

Data Integration

Connect PLCs, historians, and IT systems while orchestrating flows with the visual pipeline designer.

Explore the guide

Unified Namespace

Distribute real-time and historical data across teams with an UNS backbone and event-first architecture.

Explore the guide

Operations & Diagnostics

Monitor pipelines, system health, and connector activity with built-in dashboards and alerting hooks.

Explore the guide