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.
Before you begin
Section titled “Before you begin”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
Installation overview
Section titled “Installation overview”| Step | Description | Time |
|---|---|---|
| 1. Run installer | Run the MSI wizard or a silent install | 5 min |
| 2. Configure database | Enter the database connection, in the wizard or as properties in a silent install | 2 min |
| 3. Verify installation | Check logs and service status | 2 min |
| 4. Open firewall ports | Allow the web port and RADIUS in Windows Firewall | 2 min |
| 5. Run setup wizard | Complete initial configuration | 5 min |
Graphical Installation (MSI Wizard)
Section titled “Graphical Installation (MSI Wizard)”The MSI installer guides you through configuration with a step-by-step wizard.
-
Download and run installer
Download
MideyeServer6-<version>.msifrom the Downloads page and double-click it to start the wizard.You can also run
msiexec /i MideyeServer6-<version>.msifrom PowerShell started with Run as administrator.In 6.5.25 and earlier: right-click the installer and select Run as administrator.
-
Welcome screen
Click Next to begin installation.
-
License agreement
Read the End-User License Agreement. Select I accept the terms and click Next.
-
Custom Setup
Click Next to install in
C:\Program Files\Mideye Server 6, or click Browse to choose another folder. -
Database connection
Enter the connection to the database:
Field Description Default Database engine Microsoft SQL Server, MariaDB or MySQL Microsoft SQL Server Authentication SQL Server login (username and password), or Windows integrated (passwordless, SQL Server only) SQL Server login Server (host or IP) Database server address localhostPort Port for database connection 1433Instance (optional) Named SQL Server instance Database name The database must already exist MideyeServerDomain (optional) Domain for Windows integrated authentication Username / Password Database login. Not used with Windows integrated mideyeEncrypt connection (TLS) Recommended ☑ -
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. -
Ready to install
Click Install. Windows asks for administrator rights; click Yes.
-
Installation complete
Click Finish. The Mideye Server 6 service starts automatically.
Then open the firewall ports, see Windows Firewall.
Silent Installation (Command Line)
Section titled “Silent Installation (Command Line)”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.
Basic silent install
Section titled “Basic silent install”Start-Process msiexec.exe -Wait -ArgumentList '/i "MideyeServer6-<version>.msi" /qn'Silent install with options
Section titled “Silent install with options”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.
MSI properties reference
Section titled “MSI properties reference”| Property | Default | Description |
|---|---|---|
INSTALLDIR | C:\Program Files\Mideye Server 6 | Installation folder |
DB_ENGINE | Microsoft SQL Server | Microsoft SQL Server, MariaDB or MySQL |
DB_AUTHMODE | sql | sql (SQL Server login) or windows (Windows integrated, SQL Server only) |
DB_SERVER | localhost | Database server hostname or IP |
DB_PORT | 1433 | Port for database connection. Set 3306 for MariaDB or MySQL |
DB_NAME | MideyeServer | Database name |
DB_INSTANCE | Named SQL Server instance (optional) | |
DB_DOMAIN | Domain for Windows integrated authentication (optional) | |
DB_USERNAME | mideye | Database login. Not used with windows |
DB_PASSWORD | Database password | |
DB_ENCRYPTED | 1 | 1 encrypts the connection (TLS), 0 turns it off |
WEB_PORT | 8443 | HTTPS port for the web interface |
Post-Installation: Database Configuration
Section titled “Post-Installation: Database Configuration”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.ymlExample SQL Server configuration:
spring: datasource: url: jdbc:sqlserver://localhost:1433;databaseName=MideyeServer;encrypt=true;trustServerCertificate=true username: mideye password: your_secure_passwordQuick database creation (run in elevated Command Prompt):
sqlcmd -Q "CREATE DATABASE mideyeserver"If you create the database after installing Mideye Server, restart the Mideye Server 6 service.
The installer creates the connection during setup. To modify later, edit:
C:\Program Files\Mideye Server 6\config\application-prod.ymlExample MySQL configuration (MySQL also uses the MariaDB driver, jdbc:mariadb://):
spring: datasource: url: jdbc:mariadb://localhost:3306/mideyeserver?sslMode=trust username: mideye password: your_secure_passwordExample MariaDB configuration:
spring: datasource: url: jdbc:mariadb://localhost:3306/mideyeserver?sslMode=trust username: mideye password: your_secure_passwordAfter editing, restart the service:
Restart-Service "Mideye Server 6"Verify Installation
Section titled “Verify Installation”After installation completes, verify the service is running:
-
Open Services (
services.msc) and confirm Mideye Server 6 is running -
Check the log file for successful startup:
C:\Program Files\Mideye Server 6\log\mideyeserver.log -
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]---------------------------------------------------------- -
Get the setup challenge code:
Terminal window Select-String -Path "C:\Program Files\Mideye Server 6\log\mideyeserver.log" -Pattern "SETUP CHALLENGE"
Windows Firewall
Section titled “Windows Firewall”From 6.5.31, the installer does not create Windows Firewall rules. After installing, open these ports for inbound traffic:
| Port | Protocol | Purpose |
|---|---|---|
| 8443 (or the port you chose) | TCP | Web administration interface |
| 1812 | UDP | RADIUS 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:
Get-NetConnectionProfile(DomainAuthenticated means Domain).
Set the firewall rules:
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 DomainCheck the rules:
Get-NetFirewallRule -DisplayName 'Mideye Server 6 (*' | Format-Table DisplayName, Enabled, ProfileComplete the Setup Wizard
Section titled “Complete the Setup Wizard”-
Open the web interface in your browser:
https://localhost:8443Or use the external IP shown in the log file.
-
Enter the Setup Challenge code from the log file
-
Complete the Configuration Wizard
File Locations
Section titled “File Locations”| Path | Description |
|---|---|
C:\Program Files\Mideye Server 6\ | Installation directory |
...\config\application-prod.yml | Main configuration file |
...\config\keystore.p12 | TLS certificate and encryption keys |
...\log\mideyeserver.log | Application log |
...\log\mideyeserver.error | Error log |
...\jre\ | Bundled Java runtime |
Next steps
Section titled “Next steps”Upgrade
Section titled “Upgrade”Upgrading from Mideye Server 6.x
Section titled “Upgrading from Mideye Server 6.x”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.
-
Back up critical files before upgrading:
application-prod.yml: Database and custom settingskeystore.p12(orkeystore.pfx): Encryption keys (required for database decryption)
-
Back up the database (see Database backup). If the server is a virtual machine, also take a snapshot of it.
-
Download the new installer from the Downloads page
-
Run the upgrade with the installation wizard or from the command line, see below
-
Double-click the MSI file. The wizard shows Upgrade Mideye Server 6. Click Next.
-
Answer Yes to Stop the service and continue?
-
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.
-
The service restarts automatically (approximately 40 seconds downtime).
In PowerShell started with Run as administrator, go to the folder with the MSI file and run the upgrade:
Start-Process msiexec.exe -Wait -ArgumentList '/i "MideyeServer6-<version>.msi" /qn /norestart'The upgrade runs without the wizard or any prompts. The service is stopped and started again automatically (approximately 40 seconds downtime).
Upgrading from Mideye Server 5.x or 4.x
Section titled “Upgrading from Mideye Server 5.x or 4.x”Direct upgrades from v5 or v4 to v6 are not supported. Follow the migration path:
| From | To | Guide |
|---|---|---|
| v4.x | v5.x | Upgrade 4.x to 5.x |
| v5.x | v6.x | Upgrade 5.x to 6.x |
Uninstall
Section titled “Uninstall”-
Open Settings → Apps → Apps & features (or Add or remove programs)
-
Find Mideye Server 6 and click Uninstall
-
Follow the prompts to complete removal
Backup
Section titled “Backup”File system backup
Section titled “File system backup”Copy or compress the entire installation directory:
C:\Program Files\Mideye Server 6On 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 settingsconfig\keystore.p12(orconfig\keystore.pfx): Encryption keys
Database backup
Section titled “Database backup”Using SQL Server Management Studio:
- Right-click the database → Tasks → Back Up…
- Select backup type and destination
- Click OK
Or via command line:
sqlcmd -Q "BACKUP DATABASE mideyeserver TO DISK='C:\Backup\mideyeserver.bak'"mysqldump -u mideye -p mideyeserver > mideyeserver_backup.sqlTroubleshooting
Section titled “Troubleshooting”Service won’t start
Section titled “Service won’t start”Check the error log:
C:\Program Files\Mideye Server 6\log\mideyeserver.errorOn servers first installed with 6.5.25 or earlier: C:\Program Files (x86)\Mideye Server 6\log\mideyeserver.error.
Common issues:
| Error | Cause | Solution |
|---|---|---|
Login failed for user | Invalid database credentials | Verify username/password in application-prod.yml |
BadPaddingException | Wrong keystore password | Check certificate passphrase in configuration |
Address already in use | Port conflict | Change port or stop conflicting service |
Connection refused | Database not running | Start SQL Server/MySQL service |
Can’t access web interface
Section titled “Can’t access web interface”- Verify service is running:
services.msc→ Mideye Server 6 - Test local access:
https://localhost:8443(or your configured port) - Check the port the server listens on:
Get-NetTCPConnection -State Listen -LocalPort 8443 - Check that a firewall rule opens that port (see Windows Firewall):
Get-NetFirewallRule -DisplayName 'Mideye Server 6 (Web GUI)' | Get-NetFirewallPortFilter - 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):
Set-NetFirewallRule -DisplayName 'Mideye Server 6 (Web GUI)' -LocalPort 443Can’t connect to the database
Section titled “Can’t connect to the database”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:
- SQL Server is running and accepts TCP connections on the port in
application-prod.yml(default1433) - The database server’s hostname or IP is reachable from the Mideye Server
- The database exists and the user has permissions on it
- For named instances, the instance name is correct
- 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 not responding
Section titled “RADIUS not responding”RADIUS only starts after completing the setup wizard. Verify with:
netstat -an | findstr 1812If the port isn’t listening, check that the wizard was completed successfully.

