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.