Skip to main content

Quick Installation

It is recommended to learn about standalone deployment first, and spend a few minutes watching the installation instruction video. Some of the content in the video may differ slightly from the actual due to the earlier recording, while the overall process is basically the same.

Cloud Marketplace Installation​

It defaults to the base environment having been initialized. You can visit http://{Server IP}:38881 directly in your browser to complete the subsequent steps (default path for the manager is /usr/local/MDPrivateDeployment/).

Manual Installation​

Note

If you lack related experience, you can refer to Manual Deployment Example.

  1. Prepare a Linux server with the minimum configuration requirements of 8-core CPU, 32GB memory, 40GB data disk (excluding system disk). Ensure ports 8880, 38880, and 38881 are not occupied and that the connectivity of these ports is functional between the server and the client (In a production environment, it is recommended to implement access controls for ports 38880 and 38881 through security policies. These access addresses correspond to certain operations management functions.).

  2. Check the environment parameters by referring to Parameter Description.

  3. Install Docker. Refer to the official Installation Guide for different Linux distributions.

    warning

    Since Docker v29 (and containerd v2.1.5), containers inherited the LimitNOFILE configuration from systemd by default. This change significantly reduces the maximum open file descriptor limit (ulimit -n) in containers from 1048576 to 1024.

    This can cause HAP's internal database, middleware, and other services to fail to start or crash during operation due to insufficient file handles. Make sure to adjust this limitation to 102400 or above.

    👉 Reference: Adjusting the LimitNOFILE Limit

    1. Locate and Edit Service Files​

    Due to differences among system versions, confirm the configuration file path using the following commands:

    # Check the Docker service file path
    systemctl status docker | grep "Loaded:"

    # Check the Containerd service file path
    systemctl status containerd | grep "Loaded:"

    Use vi or vim to edit the .service file paths displayed in the output.

    2. Modify Configuration Parameters​

    Add the following line to the [Service] block in both files:

    LimitNOFILE=102400
    3. Reload Configuration and Restart​

    Execute the following commands to apply the changes immediately:

    # Reload the systemd manager configuration
    systemctl daemon-reload

    # Restart related services
    systemctl restart docker containerd
    4. Verification of Results​

    If the Soft/Hard Limit of Max open files shows as 102400, the configuration is successful:

    # Verify Docker process
    head -n 1 /proc/$(pidof dockerd)/limits && cat /proc/$(pidof dockerd)/limits | grep "Max open files"

    # Verify Containerd process
    head -n 1 /proc/$(pidof containerd)/limits && cat /proc/$(pidof containerd)/limits | grep "Max open files"

  4. Download the HAP private deployment images (Offline Package Download):

    docker pull nocoly/hap:7.1.0
    docker pull nocoly/sc:3.2.0
    docker pull nocoly/command:node2011-python312
    docker pull nocoly/doc:2.0.0

  5. Download the manager:

    wget https://pdpublic.nocoly.com/7.1.0/hap_captain_linux_amd64.tar.gz

  6. Extract the manager:

    tar -zxvf hap_captain_linux_amd64.tar.gz

  7. Start the manager with root privileges using bash ./service.sh start (Ensure that the manager remains running consistently).

  8. Once successfully started, access the service via a web browser at http://{serverIP}:38881, and proceed to configure the HAP system access address and initialize it (the initialization process takes about 3–5 minutes).

  9. After initialization is complete, apply for and bind the license key on the current page. Then, create an administrator account to access the HAP Workspace. 👏 👏

SaaS Version Experience​

The functionality of the HAP private deployment version is essentially consistent with the SaaS version. You can Register for HAP SaaS account to experience the features first.