Install Mideye on RHEL 8/9, Rocky & Alma Linux (RPM)

This guide covers installing Mideye Server 6 on RHEL-based distributions including RHEL 8/9, Rocky Linux 8/9, and Alma Linux 8/9.

Before you begin

Pre-installation Checklist Hardware, network, and firewall requirements

Downloads Get the RPM package from the Downloads page

What you'll need:

• Root or sudo access to the server
• A supported database (MariaDB, MySQL, or SQL Server)
• Network access to the Downloads page
• Firewall port assigned by Mideye Support

---

Installation overview

| Step | Description | Time | |------|-------------|------| | 1. Install package | Download and install RPM | 5 min | | 2. Set up database | Install and configure MariaDB/MySQL | 10 min | | 3. Configure connection | Edit application-prod.yml | 5 min | | 4. Open firewall | Allow HTTPS and RADIUS ports | 5 min | | 5. Run setup wizard | Complete initial configuration | 5 min |

---

Step 1: Install the package

1. Update the system packages:

   sudo dnf update -y

2. Download the RPM package from the Downloads page. Transfer it to your server:

   scp MideyeServer6-<version>.el9.noarch.rpm user@server:/tmp/

3. Install the package:

   sudo dnf install -y /tmp/MideyeServer6-<version>.el9.noarch.rpm

Tip

The package installs to /opt/mideyeserver6/ and creates a systemd service named mideyeserver6.

---

Step 2: Set up the database

Mideye Server requires a database. Choose one of the supported options below.

MariaDB

1. Install MariaDB:

   sudo dnf install -y mariadb-server

2. Enable and start the service:

   sudo systemctl enable --now mariadb

3. Secure the installation:

   sudo mysql_secure_installation

4. Create the database and user:

   sudo mysql -u root -p

   CREATE DATABASE mideyeserver
     CHARACTER SET utf8mb4
     COLLATE utf8mb4_unicode_ci;
   
   CREATE USER 'mideye'@'localhost' IDENTIFIED BY 'your_secure_password';
   GRANT ALL PRIVILEGES ON mideyeserver.* TO 'mideye'@'localhost';
   FLUSH PRIVILEGES;
   EXIT;

MySQL 8

1. Install the MySQL repository and server:

   sudo dnf install -y https://dev.mysql.com/get/mysql80-community-release-el9-1.noarch.rpm
   sudo dnf install -y mysql-community-server

2. Enable and start the service:

   sudo systemctl enable --now mysqld

3. Get the temporary root password and secure the installation:

   sudo grep 'temporary password' /var/log/mysqld.log
   sudo mysql_secure_installation

4. Create the database and user:

   mysql -u root -p

   CREATE DATABASE mideyeserver
     CHARACTER SET utf8mb4
     COLLATE utf8mb4_0900_ai_ci;
   
   CREATE USER 'mideye'@'localhost' IDENTIFIED BY 'Your_Secure_Password1!';
   GRANT ALL PRIVILEGES ON mideyeserver.* TO 'mideye'@'localhost';
   FLUSH PRIVILEGES;
   EXIT;

Note

MySQL 8 enforces password complexity and SSL by default. Use ?sslMode=TRUST in the connection string if you need to bypass SSL verification.

SQL Server

For Microsoft SQL Server, see the Windows installation guide or connect to an existing SQL Server instance.

Configure the connection in application-prod.yml:

spring:
  datasource:
    url: jdbc:sqlserver://sql-server-host:1433;database=mideyeserver;encrypt=true;trustServerCertificate=true
    username: mideye
    password: your_secure_password

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.

---

Step 3: Configure the database connection

Edit the Mideye Server configuration file:

sudo vim /opt/mideyeserver6/config/application-prod.yml

Add or update the datasource configuration:

MariaDB

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

MySQL 8

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

Caution

YAML syntax is strict—use spaces (not tabs) for indentation. Incorrect formatting will prevent the server from starting.

---

Step 4: Configure the firewall

Mideye Server requires two ports:

| Port | Protocol | Purpose | |------|----------|---------| | 8443 | TCP | Web administration interface | | 1812 | UDP | RADIUS authentication |

Open the ports in firewalld:

sudo firewall-cmd --permanent --add-port=8443/tcp
sudo firewall-cmd --permanent --add-port=1812/udp
sudo firewall-cmd --reload

Verify the configuration:

sudo firewall-cmd --list-all

---

Step 5: Start the service and complete setup

1. Enable and start the Mideye Server service:

   sudo systemctl enable --now mideyeserver6

2. Check that the service is running:

   sudo systemctl status mideyeserver6

3. Get the setup challenge code from the logs:

   sudo grep "SETUP CHALLENGE" /opt/mideyeserver6/log/mideyeserver.log

4. Open the web interface in your browser:

   https://<server-ip>:8443

5. Complete the Configuration Wizard using the setup challenge code.

Note

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

---

Verify the installation

After completing the setup wizard, verify that Mideye Server is fully operational:

# Check service status
sudo systemctl status mideyeserver6

# Verify web interface is listening
sudo ss -tlnp | grep 8443

# Verify RADIUS is listening (after wizard completion)
sudo ss -ulnp | grep 1812

# Check logs for errors
sudo tail -50 /opt/mideyeserver6/log/mideyeserver.log

---

File locations

| Path | Description | |------|-------------| | /opt/mideyeserver6/ | Installation directory | | /opt/mideyeserver6/config/application-prod.yml | Main configuration file | | /opt/mideyeserver6/config/keystore.p12 | SSL certificates and encryption keys | | /opt/mideyeserver6/log/mideyeserver.log | Application log | | /opt/mideyeserver6/log/mideyeserver.error | Error log | | /etc/systemd/system/mideyeserver6.service | Systemd service unit |

---

Next steps

Initial Configuration Complete the setup wizard and configure authentication

Integrations Connect VPNs, firewalls, and applications

Backup & Recovery Protect your configuration and data

Troubleshooting Common issues and solutions

---

Upgrade

To upgrade an existing installation:

1. Download the new RPM package from the Downloads page

2. Install the upgrade:

   sudo dnf install -y /tmp/MideyeServer6-<new-version>.el9.noarch.rpm

3. Restart the service:

   sudo systemctl restart mideyeserver6

Tip

Review the Release Notes before upgrading to check for breaking changes or required migration steps.

---

Uninstall

To remove Mideye Server:

sudo dnf remove mideyeserver6

Note

Uninstalling preserves the database, configuration files, and logs. Remove /opt/mideyeserver6/ manually if you want a complete cleanup.

---

Troubleshooting

Service won't start

Check the logs first:

sudo journalctl -u mideyeserver6 -n 50
sudo tail -100 /opt/mideyeserver6/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 8443 is occupied | Stop conflicting service or change port |

RADIUS not responding

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

sudo ss -ulnp | grep 1812

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

Can't access web interface

1. Verify the service is running: sudo systemctl status mideyeserver6
2. Check firewall: sudo firewall-cmd --list-all
3. Test local access: curl -k https://localhost:8443