Install Mideye on Debian 11/12/13 & Ubuntu 22.04/24.04

This guide covers installing Mideye Server on Debian or Ubuntu Linux with MySQL/MariaDB.

Supported versions: Debian 11, 12, 13 · Ubuntu Server 22.04, 24.04

---

Quick overview

1. Install the Mideye Server package
2. Install and configure MySQL/MariaDB
3. Start the service
4. Complete the Configuration Wizard

Time required: 15–30 minutes

---

Step 1: Install Mideye Server

1. Update your system:

   sudo apt-get update && sudo apt-get upgrade -y

2. Download the package from Mideye Server Downloads

3. Copy to your server:

   scp ~/Downloads/mideyeserver6-x.x.x.deb username@your-server:/tmp/

4. Install the package:

   sudo apt-get install /tmp/mideyeserver6-x.x.x.deb

---

Step 2: Install database

Mideye Server needs a database. Most Debian/Ubuntu installations use MySQL or MariaDB.

MySQL 8

1. Install prerequisites:

   sudo apt-get install gnupg

2. Add MySQL repository:

   cd /tmp
   wget https://dev.mysql.com/get/mysql-apt-config_0.8.34-1_all.deb
   sudo dpkg -i mysql-apt-config_0.8.34-1_all.deb

   Select mysql-8.0 when prompted.

3. Install MySQL Server:

   sudo apt-get update
   sudo apt-get install mysql-server

   During installation:

   • Set a root password (save it securely)
   • Select Use Legacy Authentication Method for compatibility

4. Verify MySQL is running:

   sudo systemctl status mysql

MariaDB

1. Install MariaDB:

   sudo apt-get install mariadb-server

2. Secure the installation:

   sudo mysql_secure_installation

3. Verify MariaDB is running:

   sudo systemctl status mariadb

---

Step 3: Configure database

Create a database and user for Mideye Server:

mysql -uroot -p

MySQL 8

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

MariaDB

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

Caution

Use a strong password in production. The example above is just a placeholder.

---

Step 4: Connect Mideye Server to database

Edit the configuration file:

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

Add your database connection (around line 13):

        url: jdbc:mariadb://localhost:3306/mideyeserver?sslMode=TRUST
        username: mideye
        password: your-secure-password

Tip

YAML is whitespace-sensitive. Use spaces (not tabs) and maintain exact indentation.

---

Step 5: Start Mideye Server

sudo systemctl enable mideyeserver6
sudo systemctl start mideyeserver6

Verify it’s running:

sudo systemctl status mideyeserver6

---

Step 6: Open firewall ports

Mideye Server needs two ports:

Port	Protocol	Purpose
8443	TCP	Web interface
1812	UDP	RADIUS authentication

sudo iptables-nft -A INPUT -p tcp --dport 8443 -j ACCEPT
sudo iptables-nft -A INPUT -p udp --dport 1812 -j ACCEPT

To make rules persistent:

sudo apt-get install iptables-persistent
sudo iptables-save > /etc/iptables/rules.v4

---

Step 7: Complete setup

Open a browser and go to:

https://your-server-ip:8443

The Configuration Wizard will guide you through:

1. Setup challenge — Find it in the logs:

   cat /opt/mideyeserver6/log/mideyeserver.log | grep CHALLENGE

2. Root password — Create administrator credentials

3. Switch connection — Enter your customer TCP port

---

File locations

File	Path
Installation directory	/opt/mideyeserver6/
Configuration	/opt/mideyeserver6/config/application-prod.yml
Certificates/Keystore	/opt/mideyeserver6/config/keystore.p12
Logs	/opt/mideyeserver6/log/mideyeserver.log
Systemd service	/etc/systemd/system/mideyeserver6.service

---

Quick troubleshooting

Server won’t start?

Check the logs:

journalctl -u mideyeserver6 -f

Database connection failed?

Verify credentials in application-prod.yml match what you created in MySQL.

No SETUP CHALLENGE in logs?

The server may not have started correctly. Check for errors:

cat /opt/mideyeserver6/log/mideyeserver.error

Port 8443 not responding?

Verify the service is listening:

netstat -tnlp | grep 8443

---

Next steps

• Configuration Wizard — Complete initial setup
• Backup procedures — Set up regular backups
• Upgrades — How to update Mideye Server
• Shared database — Multi-server deployments