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

Pre-installation Checklist Hardware, network, and database requirements

Downloads Get the MSI installer from the Downloads page

What you’ll need:

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

---

Installation overview

Step	Description	Time
1. Run installer	Execute MSI wizard or silent install	5 min
2. Configure HTTPS port	Set web interface port (default: 443)	1 min
3. Configure database	Enter SQL Server connection details	2 min
4. Generate certificate	Create self-signed certificate for HTTPS	1 min
5. Verify installation	Check logs and service status	2 min
6. Run setup wizard	Complete initial configuration	5 min

---

Graphical Installation (MSI Wizard)

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

1. Download and run installer

   Download MideyeServer6-<version>.exe from the Downloads page.

   Right-click 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. Web server port configuration

   Specify the HTTPS port for the web administration interface.

   Setting	Default	Description
   Web server port	443	The HTTPS port for accessing the admin UI

   Tip

   If port 443 is already in use (e.g., by IIS), choose an alternative like 8443.

5. Database connection

   Configure the Microsoft SQL Server connection:

   Field	Description	Example
   SQLserver IP/Hostname	Database server address	localhost or sql-server.local
   Port	SQL Server port	1433 (default)
   Database	Database name	mideyeserver
   Instance (Optional)	Named instance	SQLEXPRESS
   Domain (Optional)	For Windows Authentication	CORP.LOCAL
   User	SQL login username	mideye_svc
   Password	SQL login password
   Encrypted Connection	Enable TLS encryption	☑ Recommended

   Click Test Database Connection to verify connectivity before proceeding.

   MySQL or MariaDB

   The wizard is optimized for SQL Server. For MySQL/MariaDB, you can skip the connection test and configure the database manually after installation.

6. Certificate configuration

   Create a self-signed certificate for HTTPS:

   Setting	Default	Description
   Fully Qualified Domain Name (FQDN)	localhost	The hostname for the certificate

   Enter the server’s hostname (e.g., mideye.corp.local) for the self-signed certificate.

   Tip

   For production environments, replace this certificate with one signed by your organization’s CA or a public CA after installation.

7. Installation folder

   Choose the installation directory:

   • Default: C:\Program Files (x86)\Mideye Server 6

   Click Next to continue.

8. Ready to install

   Review your settings and click Install to begin.

9. Installation complete

   Click Finish. The Mideye Server 6 service starts automatically.

---

Silent Installation (Command Line)

For automated deployments, install silently using msiexec with MSI properties.

Basic silent install

msiexec /i MideyeServer6-<version>.msi /qn /l*v install.log

Silent install with options

msiexec /i MideyeServer6-<version>.msi /qn /l*v install.log ^
  WEB_PORT=443 ^
  DB_SERVER=sql-server.local ^
  DB_PORT=1433 ^
  DB_NAME=mideyeserver ^
  DB_USERNAME=mideye_svc ^
  DB_PASSWORD="YourSecurePassword" ^
  DB_ENCRYPTED=checked ^
  CERTIFICATE_FQDN=mideye.corp.local ^
  APPDIR="D:\Mideye Server 6"

MSI properties reference

Property	Default	Description
WEB_PORT	443	HTTPS port for web interface
DB_SERVER	localhost	SQL Server hostname or IP
DB_PORT	1433	SQL Server TCP port
DB_NAME		Database name
DB_INSTANCE		Named SQL Server instance (optional)
DB_DOMAIN		Domain for Windows Authentication (optional)
DB_USERNAME		SQL login username
DB_PASSWORD		SQL login password
DB_ENCRYPTED		Set to checked for encrypted connection
CERTIFICATE_FQDN	localhost	FQDN for self-signed certificate
APPDIR	C:\Program Files (x86)\Mideye Server 6	Installation directory

Caution

Passwords with special characters should be quoted. Avoid using ' (single quotes) in passwords for command-line installs.

---

Post-Installation: Database Configuration

The MSI wizard configures SQL Server connections automatically. For MySQL or MariaDB, configure the database connection manually after installation.

SQL Server

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

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

Example SQL Server configuration:

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

Quick database creation (run in elevated Command Prompt):

sqlcmd -Q "CREATE DATABASE mideyeserver"

MySQL / MariaDB

Edit the configuration file after installation:

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

Example MySQL configuration:

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mideyeserver?sslMode=TRUST
    username: mideye
    password: your_secure_password

Example MariaDB configuration:

spring:
  datasource:
    url: jdbc:mariadb://localhost:3306/mideyeserver?sslMode=TRUST
    username: mideye
    password: your_secure_password

After editing, restart the service:

Restart-Service "Mideye Server 6"

Shared database clusters

If multiple Mideye Servers share the same database, configure one server as Cluster Leader to avoid cleanup job conflicts. See Shared Database Clusters.

---

Verify Installation

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 (x86)\Mideye Server 6\log\mideyeserver.log

3. Look for the startup message:

   ----------------------------------------------------------
       Application 'MideyeServer' is running! Access URLs:
       Local:      https://localhost:443/
       External:   https://10.20.30.11:443/
       Profile(s): [prod]
   ----------------------------------------------------------

4. Get the setup challenge code:

   Select-String -Path "C:\Program Files (x86)\Mideye Server 6\log\mideyeserver.log" -Pattern "SETUP CHALLENGE"

---

Complete the Setup Wizard

1. Open the web interface in your browser:

   https://localhost:443

   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

Note

The setup wizard requires a firewall port opening from Mideye Support. Contact support@mideye.com if you haven’t received your port assignment.

---

File Locations

Path	Description
C:\Program Files (x86)\Mideye Server 6\	Installation directory
...\config\application-prod.yml	Main configuration file
...\config\keystore.pfx	SSL certificate and encryption keys
...\log\mideyeserver.log	Application log
...\log\mideyeserver.error	Error log
...\jre\	Bundled Java runtime

---

Windows Firewall

The installer automatically creates Windows Firewall rules for:

Port	Protocol	Purpose
443 (or custom)	TCP	Web administration interface
1812	UDP	RADIUS authentication

Note

Firewall rules are created for the Private network profile by default. If your server uses a Domain or Public profile, adjust the rules accordingly.

---

Next steps

Initial Configuration Complete the setup wizard

Integrations Connect VPNs and applications

Backup & Recovery Protect your configuration and data

Troubleshooting Common issues and solutions

---

Upgrade

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.

1. Back up critical files before upgrading:

   • application-prod.yml — Database and custom settings
   • keystore.pfx — Encryption keys (required for database decryption)

2. Download the new installer from the Downloads page

3. Run the installer as administrator

4. Confirm the upgrade when prompted

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

Database encryption

Mideye Server 6 encrypts RADIUS shared secrets in the database. Keep backups of keystore.pfx — if lost, encrypted data cannot be recovered. See Database Encryption.

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

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

Note

Uninstalling preserves the database and configuration files. Remove the installation directory manually for a complete cleanup.

---

Backup

File system backup

Copy or compress the entire installation directory:

C:\Program Files (x86)\Mideye Server 6

Critical files to always back up:

• config\application-prod.yml — Configuration settings
• config\keystore.pfx — Encryption keys

Database backup

SQL Server

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:

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

MySQL / MariaDB

mysqldump -u mideye -p mideyeserver > mideyeserver_backup.sql

---

Troubleshooting

Service won’t start

Check the error log:

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

1. Verify service is running: services.msc → Mideye Server 6
2. Check Windows Firewall rules allow traffic on your configured port
3. Test local access: https://localhost:443 (or your configured port)
4. Check if another application uses the same port

Database connection test fails

During installation, if the database test fails:

1. Verify SQL Server is running and accepting connections
2. Check the server hostname/IP is reachable from the Mideye Server
3. Confirm the database exists and the user has appropriate permissions
4. For named instances, ensure you’ve entered the instance name correctly
5. For encrypted connections, verify SSL/TLS is configured on SQL Server

RADIUS not responding

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

netstat -an | findstr 1812

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