Skip to content

Install Mideye on Windows Server (MSI Installer)

This guide covers installing Mideye Server 6 on Windows Server 2016, 2019, 2022, or 2025 using either the graphical installer wizard or silent command-line installation.

What you’ll need:

  • Local administrator privileges
  • A supported database (SQL Server, MySQL, or MariaDB) with credentials ready
  • Network access to the Downloads page
  • An outbound firewall opening to Mideye Switch, on the port assigned by Mideye Support

StepDescriptionTime
1. Run installerRun the MSI wizard or a silent install5 min
2. Configure databaseEnter the database connection, in the wizard or as properties in a silent install2 min
3. Verify installationCheck logs and service status2 min
4. Open firewall portsAllow the web port and RADIUS in Windows Firewall2 min
5. Run setup wizardComplete initial configuration5 min

The MSI installer guides you through configuration with a step-by-step wizard.

  1. Download and run installer

    Download MideyeServer6-<version>.msi from the Downloads page and double-click it to start the wizard.

    You can also run msiexec /i MideyeServer6-<version>.msi from PowerShell started with Run as administrator.

    In 6.5.25 and earlier: right-click the installer and select Run as administrator.

  2. Welcome screen

    Click Next to begin installation.

  3. License agreement

    Read the End-User License Agreement. Select I accept the terms and click Next.

  4. Custom Setup

    Click Next to install in C:\Program Files\Mideye Server 6, or click Browse to choose another folder.

  5. Database connection

    Enter the connection to the database:

    FieldDescriptionDefault
    Database engineMicrosoft SQL Server, MariaDB or MySQLMicrosoft SQL Server
    AuthenticationSQL Server login (username and password), or Windows integrated (passwordless, SQL Server only)SQL Server login
    Server (host or IP)Database server addresslocalhost
    PortPort for database connection1433
    Instance (optional)Named SQL Server instance
    Database nameThe database must already existMideyeServer
    Domain (optional)Domain for Windows integrated authentication
    Username / PasswordDatabase login. Not used with Windows integratedmideye
    Encrypt connection (TLS)Recommended☑
  6. Web admin interface

    This page shows the HTTPS port for the web interface (8443). A self-signed certificate is created automatically. You can replace it with your own certificate later in the web interface, see Certificate management. Click Next.

  7. Ready to install

    Click Install. Windows asks for administrator rights; click Yes.

  8. Installation complete

    Click Finish. The Mideye Server 6 service starts automatically.

    Then open the firewall ports, see Windows Firewall.


For automated deployments, install silently using msiexec with MSI properties. In PowerShell started with Run as administrator, go to the folder with the MSI file and run one of the commands below.

Terminal window
Start-Process msiexec.exe -Wait -ArgumentList '/i "MideyeServer6-<version>.msi" /qn'
Terminal window
Start-Process msiexec.exe -Wait -ArgumentList @(
'/i "MideyeServer6-<version>.msi"', '/qn'
'WEB_PORT=8443'
'DB_SERVER=sql-server.local'
'DB_PORT=1433'
'DB_NAME=MideyeServer'
'DB_USERNAME=mideye'
'DB_PASSWORD="YourSecurePassword"'
'DB_ENCRYPTED=1'
'INSTALLDIR="D:\Mideye Server 6"'
)

Put each property on its own line, within single quotes.

PropertyDefaultDescription
INSTALLDIRC:\Program Files\Mideye Server 6Installation folder
DB_ENGINEMicrosoft SQL ServerMicrosoft SQL Server, MariaDB or MySQL
DB_AUTHMODEsqlsql (SQL Server login) or windows (Windows integrated, SQL Server only)
DB_SERVERlocalhostDatabase server hostname or IP
DB_PORT1433Port for database connection. Set 3306 for MariaDB or MySQL
DB_NAMEMideyeServerDatabase name
DB_INSTANCENamed SQL Server instance (optional)
DB_DOMAINDomain for Windows integrated authentication (optional)
DB_USERNAMEmideyeDatabase login. Not used with windows
DB_PASSWORDDatabase password
DB_ENCRYPTED11 encrypts the connection (TLS), 0 turns it off
WEB_PORT8443HTTPS port for the web interface

The MSI wizard and silent installs write the database connection to application-prod.yml based on provided input. The connection can be manually edited in that file after installation.

The installer creates the connection during setup. To modify later, edit:

C:\Program Files\Mideye Server 6\config\application-prod.yml

Example SQL Server configuration:

spring:
datasource:
url: jdbc:sqlserver://localhost:1433;databaseName=MideyeServer;encrypt=true;trustServerCertificate=true
username: mideye
password: your_secure_password

Quick database creation (run in elevated Command Prompt):

Terminal window
sqlcmd -Q "CREATE DATABASE mideyeserver"

If you create the database after installing Mideye Server, restart the Mideye Server 6 service.


After installation completes, verify the service is running:

  1. Open Services (services.msc) and confirm Mideye Server 6 is running

  2. Check the log file for successful startup:

    C:\Program Files\Mideye Server 6\log\mideyeserver.log
  3. Look for the startup message:

    ----------------------------------------------------------
    Application 'MideyeServer' is running! Access URLs:
    Local: https://localhost:8443/
    External: https://10.20.30.11:8443/
    Profile(s): [prod]
    ----------------------------------------------------------
  4. Get the setup challenge code:

    Terminal window
    Select-String -Path "C:\Program Files\Mideye Server 6\log\mideyeserver.log" -Pattern "SETUP CHALLENGE"

From 6.5.31, the installer does not create Windows Firewall rules. After installing, open these ports for inbound traffic:

PortProtocolPurpose
8443 (or the port you chose)TCPWeb administration interface
1812UDPRADIUS authentication

Open them in Windows Defender Firewall with Advanced Security (wf.msc), or in PowerShell started with Run as administrator. Use the port you chose for the web interface, and the network profile the server uses.

Check the profile with:

Terminal window
Get-NetConnectionProfile

(DomainAuthenticated means Domain).

Set the firewall rules:

Terminal window
New-NetFirewallRule -DisplayName "Mideye Server 6 (Web GUI)" -Group "Mideye" `
-Direction Inbound -Action Allow -Protocol TCP -LocalPort 8443 -Profile Domain
New-NetFirewallRule -DisplayName "Mideye Server 6 (RADIUS)" -Group "Mideye" `
-Direction Inbound -Action Allow -Protocol UDP -LocalPort 1812 -Profile Domain

Check the rules:

Terminal window
Get-NetFirewallRule -DisplayName 'Mideye Server 6 (*' |
Format-Table DisplayName, Enabled, Profile

  1. Open the web interface in your browser:

    https://localhost:8443

    Or use the external IP shown in the log file.

  2. Enter the Setup Challenge code from the log file

  3. Complete the Configuration Wizard


PathDescription
C:\Program Files\Mideye Server 6\Installation directory
...\config\application-prod.ymlMain configuration file
...\config\keystore.p12TLS certificate and encryption keys
...\log\mideyeserver.logApplication log
...\log\mideyeserver.errorError log
...\jre\Bundled Java runtime


The installer automatically detects existing installations and performs an in-place upgrade. When the wizard detects a previous version, it displays an upgrade confirmation dialog.

  1. Back up critical files before upgrading:

    • application-prod.yml: Database and custom settings
    • keystore.p12 (or keystore.pfx): Encryption keys (required for database decryption)
  2. Back up the database (see Database backup). If the server is a virtual machine, also take a snapshot of it.

  3. Download the new installer from the Downloads page

  4. Run the upgrade with the installation wizard or from the command line, see below

  1. Double-click the MSI file. The wizard shows Upgrade Mideye Server 6. Click Next.

  2. Answer Yes to Stop the service and continue?

  3. Click Install and approve two administrator prompts: first for Mideye Server, then for Windows PowerShell. The second one is needed to prepare the upgrade. If you decline it, the upgrade stops and nothing is changed.

  4. The service restarts automatically (approximately 40 seconds downtime).

Direct upgrades from v5 or v4 to v6 are not supported. Follow the migration path:

FromToGuide
v4.xv5.xUpgrade 4.x to 5.x
v5.xv6.xUpgrade 5.x to 6.x

  1. Open Settings → Apps → Apps & features (or Add or remove programs)

  2. Find Mideye Server 6 and click Uninstall

  3. Follow the prompts to complete removal


Copy or compress the entire installation directory:

C:\Program Files\Mideye Server 6

On servers first installed with 6.5.25 or earlier: C:\Program Files (x86)\Mideye Server 6.

Critical files to always back up:

  • config\application-prod.yml: Configuration settings
  • config\keystore.p12 (or config\keystore.pfx): Encryption keys

Using SQL Server Management Studio:

  1. Right-click the database → Tasks → Back Up…
  2. Select backup type and destination
  3. Click OK

Or via command line:

Terminal window
sqlcmd -Q "BACKUP DATABASE mideyeserver TO DISK='C:\Backup\mideyeserver.bak'"

Check the error log:

C:\Program Files\Mideye Server 6\log\mideyeserver.error

On servers first installed with 6.5.25 or earlier: C:\Program Files (x86)\Mideye Server 6\log\mideyeserver.error.

Common issues:

ErrorCauseSolution
Login failed for userInvalid database credentialsVerify username/password in application-prod.yml
BadPaddingExceptionWrong keystore passwordCheck certificate passphrase in configuration
Address already in usePort conflictChange port or stop conflicting service
Connection refusedDatabase not runningStart SQL Server/MySQL service
  1. Verify service is running: services.msc → Mideye Server 6
  2. Test local access: https://localhost:8443 (or your configured port)
  3. Check the port the server listens on: Get-NetTCPConnection -State Listen -LocalPort 8443
  4. Check that a firewall rule opens that port (see Windows Firewall): Get-NetFirewallRule -DisplayName 'Mideye Server 6 (Web GUI)' | Get-NetFirewallPortFilter
  5. Check if another application uses the same port

If an upgrade to 6.5.27–6.5.30 changed the web interface rule to port 8443, correct it to the port the server uses (443 in this example):

Terminal window
Set-NetFirewallRule -DisplayName 'Mideye Server 6 (Web GUI)' -LocalPort 443

If the connection details are wrong, Mideye Server can’t connect when the service starts, and the error is in mideyeserver.error (see Service won’t start). Check that:

  1. SQL Server is running and accepts TCP connections on the port in application-prod.yml (default 1433)
  2. The database server’s hostname or IP is reachable from the Mideye Server
  3. The database exists and the user has permissions on it
  4. For named instances, the instance name is correct
  5. For encrypted connections, TLS is configured on SQL Server

Then correct the connection in application-prod.yml (see Post-Installation: Database Configuration) and restart the Mideye Server 6 service.

RADIUS only starts after completing the setup wizard. Verify with:

Terminal window
netstat -an | findstr 1812

If the port isn’t listening, check that the wizard was completed successfully.