Install Mideye — Linux, Windows & Container Platforms

Mideye Server runs on Linux (RHEL, Rocky, Debian, Ubuntu), Windows Server, Docker, and Podman.

What you need

One server — that’s the key requirement. Mideye Server installs with a local database by default, creating a self-sufficient “island” that handles both authentication logic and data storage.

Most customers prefer this approach:

Simple to deploy and maintain
No external database dependencies
Each server is fully autonomous

High availability options

Option 1: Multiple standalone servers (recommended)

Deploy multiple standalone servers with a load balancer or failover mechanism in front. Each server is configured separately, but you can copy the database and encryption configuration (keystore.pfx) from the first server to quickly provision additional nodes.

Trade-off: Configuration changes must be applied to each server individually. Without a synchronization script, configurations can drift if you forget to update all servers.

Option 2: Shared database cluster

For organizations with existing database infrastructure, multiple Mideye Servers can share a single database cluster. This requires:

Copy the encryption key — The keystore.pfx file and its password must be copied from the first server to all others. RADIUS shared secrets are encrypted, and all servers need the same key.
Configure cluster leadership — Only one server should run database cleanup jobs. Set cluster-leader: false on secondary servers to prevent deadlocks.

Trade-off: If the database cluster has issues, all Mideye Servers lose access to configuration and no one can authenticate until the database is restored.

See Shared Database Clusters for detailed setup instructions.

Licensing

You can deploy as many Mideye Servers as you need under the same license — there’s no per-server fee.

If your servers connect to the Mideye central SMS/Push switch from different source IP addresses, contact support@mideye.com so we can authorize the additional IPs.

Installation guides

Choose your platform:

Platform	Supported versions
RHEL / Rocky Linux	RHEL 8/9, Rocky Linux 8/9/10
Debian / Ubuntu	Debian 11/12/13, Ubuntu Server 22.04/24.04
Windows Server	Windows Server 2019/2022/2025
Docker	Any Docker-compatible host
Podman	RHEL-based systems with Podman

Upgrading from v5? See Migration from v5 for database migration and upgrade procedures.

Database options

Mideye Server supports:

MySQL — Included in Linux package installations
MariaDB — Drop-in MySQL replacement, popular on Debian/Ubuntu
Microsoft SQL Server — Required for Windows installations, optional for Linux

Most Linux installations use the bundled MySQL/MariaDB. Windows installations use SQL Server (Express edition works fine for most deployments).

TLS certificate

A self-signed TLS certificate is generated automatically during installation. This is sufficient for initial setup and testing.

You can replace it with your own certificate later through the Mideye Server web interface — no reinstallation required. See Certificate Management for details.

After installation

Once installed, complete the Configuration Wizard to set up:

Root administrator password
Mideye Switch connection (for SMS/Push delivery)
Optional: Air-gapped mode for offline deployments

Directory integration (AD/LDAP) and RADIUS clients are configured through the web interface after the initial wizard.