mindzieStudio On-Premise Installation Guide

Overview

mindzieStudio's AI-Driven Process Mining and Automation platform offers a comprehensive and in-depth understanding of an organization's workflows within your organization, providing unparalleled visibility into processes, identifying bottlenecks, inefficiencies, and areas for optimization. By leveraging process mining tools, users can gain real-time insights, enabling them to streamline operations, improve compliance, and enhance overall efficiency. mindzieStudio empowers organizations to make data-driven decisions, optimize processes for maximum productivity, reduce operational costs, accelerate process execution, and ensure a seamless, standardized workflow across their enterprise.

Key Benefits

  • Improve Process Times - Optimize workflows for faster execution
  • Reduce Waste - Identify and eliminate inefficiencies
  • Monitor and Ensure Compliance - Maintain regulatory standards

Installation Type

This guide covers both online and offline installations. Choose based on your environment:

Installation Type When to Use
Online Server has internet connectivity
Offline Server has no internet access (air-gapped)

For offline installations, all required files must be downloaded on a machine with internet access and transferred to the target server.


Pre-Installation Checklist

Complete all items below BEFORE your scheduled installation. Print this page and check off each item.

SSL Certificate

  • SSL certificate obtained from IT/Security department
  • Certificate file(s) ready for import into IIS
  • Certificate matches the planned domain name

DNS Configuration

  • DNS entry created (e.g., mindzie.[yourcompany].com)
  • DNS record points to the VM's IP address
  • DNS propagation verified (can resolve the hostname)

SQL Server (Choose One)

Option A: Use Existing SQL Server

  • SQL Server instance identified and accessible from the VM
  • Database administrator available who can:
    • Create a new database called "mindzie"
    • Create appropriate login with db_owner permissions (see Authentication Mode below)
    • Provide connection credentials
  • Authentication mode determined (see next section)

Option B: Install SQL Server Express on the VM

  • SQL Server Express installer available (download if online, or transfer if offline)
  • IT person available to install SQL Server Express
  • Understood: SQL Express is free but lacks enterprise features (backup, mirroring)
  • See Install SQL Server Express guide

SQL Server Authentication Mode

Choose one of the following authentication modes:

Mode Requirements Best For
Mixed Mode (SQL Server + Windows Auth) SQL login with username/password Simpler setup, services run as default account
Windows Authentication Only Windows service account with SQL permissions Environments requiring Windows-only auth

For Mixed Mode:

  • SQL Server has Mixed Mode authentication enabled
  • SQL login credentials will be created (username/password)

For Windows Authentication Only:

  • Windows service account identified or will be created
  • Service account will have db_owner access to mindzie database
  • Permission to configure Windows services to run under this account

Virtual Machine

  • Windows Server 2019 or later provisioned
  • Meets minimum specs: 4+ cores, 8GB+ RAM, 100GB+ storage (see Technical Requirements)
  • Administrator with full access available for:
    • Installing software
    • Configuring IIS
    • Managing Windows services
  • Internet connectivity available (for online installation only)

Additional Items

  • mindzieStudio license key received from mindzie
  • Scheduled downtime window communicated to users (if applicable)

Offline Installation Only

If your server has no internet access, you will need to download files during Steps 3 and 4 below on a machine with internet, then transfer them to the target server (via USB drive, network share, etc.).


Installation Steps

Step 1: SQL Server Configuration

Requirements:

  1. Permission to create databases on your SQL server
  2. SQL Server Management Studio (recommended)

Setup Process:

  1. Launch SQL Server Management Studio
  2. Create the mindzie database with the correct collation

IMPORTANT: Database Collation Requirement

The mindzie database must be created with the collation SQL_Latin1_General_CP1_CI_AS. This collation is required for correct string comparisons throughout the application.

Download the database creation script:

Download create-mindzie-database.sql

To use the script:

  1. Open SQL Server Management Studio
  2. Connect to your SQL Server instance
  3. Open the downloaded script file
  4. Execute the script (F5)

The script will:

  • Verify the database doesn't already exist
  • Create the mindzie database with the correct collation
  • Display confirmation of the collation setting

Then choose based on your authentication mode:

If Using Mixed Mode (SQL Server Authentication)

  1. Ensure SQL Server has Mixed Mode authentication enabled
  2. Create a SQL login called "mindzie"
  3. Grant the "mindzie" login db_owner access to the "mindzie" database

If Using Windows Authentication Only

  1. Identify or create a Windows service account (e.g., DOMAIN\mindzieService)
  2. In SQL Server, create a login for this Windows account
  3. Grant the Windows login db_owner access to the "mindzie" database
  4. Note: You will configure the mindzie services to run under this account in Step 4

Step 2: Internet Information Services (IIS)

Configuration:

  1. Make sure the server has IIS enabled prior to installing .NET
  2. If you already installed .NET then please repair the .NET install
  3. Add "WebSocket Protocol" under Web Server -> Application Development

WebSocket Protocol Configuration

Note: Ensure IIS is properly configured before proceeding to the next step.

Step 2a: Remove WebDAV

WebDAV must be removed from the server. This feature intercepts HTTP requests (PUT, DELETE, MOVE) before they reach mindzieStudio, causing API failures.

Open PowerShell as Administrator and run:

Remove-WindowsFeature Web-DAV-Publishing

A server restart may be required. See Disable WebDAV for full details.

Step 3: .NET Runtime Installation

Online Installation

Download and install ASP.NET Core 8 Runtime Hosting Bundle:

Download ASP.NET Core 8 Runtime Hosting Bundle

Run the installer and follow the wizard to complete installation.

Offline Installation

Download the hosting bundle on a machine with internet access, then transfer to the server:

Download ASP.NET Core 8 Runtime Hosting Bundle

On the server:

  1. Locate dotnet-hosting-8.0.6-win.exe
  2. Run the installer as Administrator
  3. Follow the installation wizard
  4. Restart IIS after installation completes

Step 4: Install mindzieStudio

Online Installation

Download mindzieStudio Enterprise Edition:

Download mindzieStudio Setup

Run the Installation:

  • Execute mindzieStudioSetup.exe
  • Accept the License Agreement
  • Leave all screens as the defaults

Offline Installation

Download the following files on a machine with internet access, then transfer all three to the server:

1. Download mindzieStudio Setup

2. Download mindzieStudio Update Package

On the server:

  • Place all three files in the same directory
  • Execute mindzieStudioSetup.exe
  • Accept the License Agreement
  • Leave all screens as the defaults

License Configuration (All Installations)

  1. After installation, run the EnterpriseConfiguration app
  2. Paste your license into the text box and click "Activate New License"

Database Configuration

  1. Click the "Database Settings" button
  2. Click "Change SQL Server"
  3. Configure based on your authentication mode:

If Using Mixed Mode (SQL Server Authentication):

  • Ensure the correct SQL Server name is entered
  • Set Authentication to "SQL Server Authentication"
  • Enter the SQL username and password
  • Click "Update Database"

If Using Windows Authentication Only:

  • Ensure the correct SQL Server name is entered
  • Set Authentication to "Windows Authentication"
  • Click "Update Database"
  • Important: You must also configure the mindzie services to run under the Windows service account:
    1. Open Windows Services (services.msc)
    2. Locate the mindzie services
    3. Right-click each service -> Properties -> Log On tab
    4. Select "This account" and enter the service account credentials
    5. Restart the services

Step 4a: Install Python (Optional)

If you plan to use Python enrichments or Python Script actions, install Python now.

When is Python Required?

Python is only required if you want to use:

  • Python Enrichment - Custom data transformations using Python scripts
  • Python Script Action - Automated integrations, webhooks, database exports, notifications

If you do not plan to use these features, skip this step.

See Install Python for detailed installation instructions.

Step 5: Configure SSL in IIS

SSL Configuration:

  1. Configure SSL Certificate in Internet Information Services (IIS)
  2. Add https binding using the SSL certificate from step 1
  3. This should not be localhost for production installations

Recommended DNS:

  • mindziestudio.[companyname].com

Important Notes:

  • SSL configuration is required for production environments
  • Ensure proper certificate management for security

Updates

Online Servers (Auto-Update)

Servers with internet connectivity can use automatic updates. See Auto Update for configuration details.

Offline Servers (Manual Update)

When updates are available for offline servers, download the latest files and run the setup again.

Required Downloads for Update:

1. Download mindzieStudio Setup

2. Download mindzieStudio Update Package

Update Process:

  1. Download all three files above on a machine with internet access
  2. Transfer the files to the server
  3. Place all three files in the same directory on the server
  4. Run mindzieStudioSetup.exe - the setup will handle everything automatically

Additional Configuration

Upgrades

When upgrading your Enterprise server, note that you will need to re-add your certificate to the website in IIS.

Licensing Updates

If you have upgraded your license, you will need to take the following steps for it to take effect:

  1. Run the Enterprise Configuration tool and click refresh license
  2. Restart the mindzie website in IIS

LLM AI Integration

To utilize an on-premise LLM for mindzie's AI copilot and other features, please contact support@mindzie.com for details.


Support

Need help with your installation? Contact us:

Email: support@mindzie.com

Our support team is here to help with any installation or configuration questions.


For technical specifications and requirements, see the Technical Requirements page.