1. Introduction

This document provides the formal installation procedure for "MirAI-V2 (version 2.0.3)", an on-premise AI video-management system (VMS) provided by MarkAny Co., Ltd. It covers installing the system into the customer environment, performing initial configuration, and verifying correct operation.

1.1 Scope

This document covers installation of the MirAI-V2 server and client, initial configuration including license activation, post-install verification, uninstallation, and troubleshooting of installation-time issues. For day-to-day operation and periodic maintenance procedures, refer to the Operations & Maintenance Manual. For acceptance items and test procedures, refer to the Acceptance & Test Specification.

1.2 Audience

This document is intended for the installer who performs the deployment, and for the system administrator who manages the system afterward. It assumes basic knowledge of Windows operation, network and firewall configuration, and working with administrator privileges.

1.3 Prerequisites (Operating Environment)

Before starting installation, confirm that the target machines meet the operating-environment and system requirements. Detailed server/client hardware requirements, GPU / CUDA / TensorRT requirements, network/port requirements, and supported cameras are documented in the separate System Requirements Specification.

2. Prerequisites

Before running the installer, confirm and prepare each item in the checklist below. The NVIDIA driver and CUDA Toolkit must be installed beforehand. All other dependencies (PostgreSQL, VC++ Runtime, GStreamer, CUDA libraries, etc.) are installed automatically by the MirAI-V2 installer.

2.1 Pre-Installation Checklist

• OS: Windows 10 or 11 (64-bit) is installed and fully up to date.
• GPU driver: NVIDIA GPU driver version 560 or higher is installed.
  Verify: run nvidia-smi in Command Prompt; your GPU should be listed.
  Download: https://www.nvidia.com/drivers
• CUDA Toolkit: CUDA Toolkit 12.8 is installed.
  Verify: run nvcc --version in Command Prompt; it should report "release 12.8".
  Download: https://developer.nvidia.com/cuda-downloads
• Free disk space: At least 50 GB free for installation (recording storage is reserved separately).
• Administrator rights: The account running the installer has administrator privileges on the target computer.
• Network / ports: If the server and client are on separate machines, the required ports (7878 / 7575 / 7979 TCP, 7676 UDP, etc.) can be opened on the server firewall. See section 5.3 "Network, Ports, and TLS".
• Database (PostgreSQL): The system uses PostgreSQL. PostgreSQL is installed automatically by the installer, so no prior installation is required. Confirm that DB port 5432 is available locally (no conflict with other applications).
• License information: The license key (format XXXXX-XXXXX-XXXXX-XXXXX), or the offline activation procedure and contact, is ready. License key: ライセンスキー / License Key
• Installer: The official MirAI-V2 installer (MirAI.exe) is available.

3. Server Installation

The server is the core machine that runs the AI inference engine, video ingest (RTSP capture), recording, the API / WebSocket / TCP services, and the database. Follow the steps below to install it. For a single-machine setup (server and client on the same machine), select "Client and Server" at the installation-type step in this chapter to install the client at the same time.

3.1 Run the Installer

1. Double-click the installer file MirAI.exe.
2. If Windows prompts "Do you want to allow this app to make changes to your device?", click Yes.
3. Select the installation language (English / Japanese / Korean).
4. Review and accept the License Agreement, then click Next.

3.2 Choose Installation Type (Components)

The installer asks what to install. To set the machine up as a server, choose one of the following.

1. Select the installation type that matches your deployment.
2. Click Next.

3.3 Run the Installation

The installer automatically performs the following. Please wait until it completes.

1. Install VC++ Runtime (if not already present).
2. Install the PostgreSQL database.
3. Copy the MirAI Server files.
4. Copy the MirAI Client files (when "Client and Server" is selected).
5. Install GStreamer (video processing).
6. Copy the NVIDIA CUDA libraries.
7. Register the MirAI service (configured to start automatically on Windows boot).
8. Start the MirAI server.
9. Create a desktop shortcut.

3.4 Confirm Service Registration

After installation completes, the MirAI server is registered as a Windows background service and configured to start automatically. You can check and control its status as follows.

1. Confirm that the MirAI system-tray icon appears in the notification area (near the clock at the lower-right of the screen).
2. To control the service manually, right-click the system-tray icon and select Start Server / Stop Server.
3. You can also control it from Command Prompt (run as Administrator):

   net start com.markany.miraix
   net stop com.markany.miraix

3.5 First Boot and First-Time AI Engine Build

After the server is installed, on the first login from the client (or on first boot), the AI engine builds models optimized for your GPU (TensorRT engine).

4. Client Installation

The client is a dedicated application for live grid view, AI pipeline editing, and browsing notification/incident history. The steps below describe installing the client only on a machine separate from the server (for a single-machine setup, this chapter is not required).

4.1 Run the Installer and Select Components

1. On the client machine, double-click MirAI.exe.
2. Click Yes at the Windows User Account Control prompt.
3. Select the installation language (English / Japanese / Korean).
4. Accept the License Agreement and click Next.
5. Select Client only as the installation type and click Next.

4.2 Run the Installation and Confirm Completion

1. The installer automatically installs the MirAI Client files and required dependencies (GStreamer, VC++ Runtime, etc.). Please wait until it completes.
2. After installation completes, confirm that a MirAI shortcut has been created on the desktop.

5. Initial Configuration

After installation, perform the initial configuration to bring the system to an operational state. Complete the first login, license activation, network/port/TLS, and time-zone/language settings in order.

5.1 First Login and Password Change

1. Double-click the MirAI icon on the desktop to launch the client (you can also launch it from the Start Menu).
2. On the login screen, enter the following.

   Field	What to Enter
   Server IP	localhost (if the server is on this machine), or the server's IP address サーバー IP / Server IP
   ID	admin
   Password	The password entered at first login becomes the admin initial password. 初期パスワード / Initial Password

3. Click Log In.
4. On first connection, a certificate warning for the self-signed certificate may appear. This is normal. Click Yes to trust the server (see section 5.3 "Network, Ports, and TLS" for details).

To change the password:

1. Open Settings (gear icon) → Users.
2. Select the admin user and click Edit.
3. Change the password to a sufficiently strong one.
4. Click Save.

5.2 License Activation

Activate the license to use the system legitimately. Depending on whether internet access is available, perform either online or offline activation.

5.2.1 Online Activation

1. Open Settings → License.
2. Enter the license key (format XXXXX-XXXXX-XXXXX-XXXXX).
3. Click Activate.

5.2.2 Offline Activation (No Internet Access)

1. Open Settings → License.
2. Click Generate Request File and save the generated file.
3. Send the saved file to MarkAny support. Contact: support@markany.com
4. Receive the returned license file.
5. Click Upload License File, select the received file, and click Apply.

5.3 Network, Ports, and TLS

MirAI-V2 uses the following ports for client–server communication and for communication with cameras. If the client and server are on separate machines, allow inbound traffic on the relevant ports on the server firewall.

Firewall setup (server side):

1. Open Windows Defender Firewall → Advanced Settings.
2. Click Inbound Rules → New Rule.
3. Select Port → TCP and enter ports 7878, 7575, 7979.
4. Select Allow the connection, apply to all profiles, and save the rule as "MirAI TCP".
5. Repeat for UDP, entering port 7676, and save as "MirAI UDP".

Alternatively, run the following in PowerShell (as Administrator):

New-NetFirewallRule -DisplayName "MirAI TCP" -Direction Inbound -Port 7878,7575,7979 -Protocol TCP -Action Allow
New-NetFirewallRule -DisplayName "MirAI UDP" -Direction Inbound -Port 7676 -Protocol UDP -Action Allow

5.4 Time Zone and Language

1. The client display language is the one selected during initial installation (English / Japanese / Korean).
2. Recording and event timestamps are recorded based on the Windows system time and time zone of the server machine. Before starting operation, confirm that the time zone is set correctly under Windows Settings → Time & language on the server machine. Time zone: タイムゾーン / Time Zone (e.g., (UTC+09:00) Osaka, Sapporo, Tokyo)
3. When operating multiple machines, confirm that time is synchronized between server and client (e.g., via NTP).

6. Post-Install Verification

After completing the initial configuration, verify that the system is operating correctly. Confirm each item in the checklist below. For detailed acceptance items, test procedures, and pass/fail criteria, refer to the Acceptance & Test Specification.

• Server reachable: The server is running and the system-tray icon indicates the running state. If the client is on a separate machine, the server IP/ports are reachable.
• Login OK: You can log in successfully from the client with the admin account.
• Add a test camera: You can add one test camera. From Settings → Camera Management → + Add Camera, register a camera by IP-range auto-discovery or by manually entering the RTSP URL, then click Add.
• Live view: The video of the added camera appears in the live-view grid.
• AI status running: The AI engine is in the running state and AI inference is operating normally (after the first-time build completes).

To add a test camera:

1. Open Settings → Camera Management.
2. Click + Add Camera.
3. Choose a registration method:
   • Automatic: Enter the IP range of the cameras (e.g., 192.168.1.1 to 192.168.1.255) and click Search.
   • Manual: Enter the camera's RTSP URL directly.
4. Select the discovered (or entered) camera and click Add.
5. Confirm that the video appears in the live-view grid.

7. Uninstall

To remove the system from a machine, follow the steps below.

1. Right-click the system-tray icon and select Exit to stop the system-tray app.
2. Open Windows Settings → Apps, find MirAI in the list, and click Uninstall.
3. Follow the uninstaller prompts to proceed.

For the server (and the client, if installed), the uninstaller automatically performs the following.

• Stops the MirAI server service.
• Removes all program files.
• Removes the service registration.
• Removes the desktop and Start Menu shortcuts.

8. Troubleshooting

The following lists common installation-time issues and how to resolve them. For issues and remedies related to post-deployment operation and maintenance, refer to the Operations & Maintenance Manual.