All Products
Search

This Product

    PolarDB:Mount on an ECS instance

    Document Center

    PolarDB:Mount on an ECS instance

    Last Updated:Jul 13, 2026

    This topic shows you how to mount PolarDB Agent LakeBase on an ECS instance.

    Note

    For a production environment, we recommend deploying using SidecarSet. Mounting on an ECS instance is suitable for non-containerized deployment or for testing and verification purposes.

    Download the client

    wget https://lakebase-client.oss-cn-beijing.aliyuncs.com/lakebase-client-latest

    (optional)Enable SSL

    If you use PolarDB Agent LakeBase in a sandbox-like environment, we recommend that you enable SSL to enhance security and prevent network injection attacks.

    Note

    Turning SSL on or off restarts the backend service. Perform this operation during off-peak hours.

    1. On the details page of the destination cluster in the PolarDB console, click the AI Cache tab, click the destination PolarDB Agent LakeBase instance to open its details page, and then click the SSL Settings tab.

      1. In both the Primary Endpoint card and the Cluster Endpoint card, turn on the SSL Status switch. The SSL status changes from Off to On. Both addresses share the same certificate.

      2. Wait until the SSL status becomes On.

    2. Click Download.

      1. Extract the downloaded certificate archive.

      2. Rename the .pem file to ca.pem.

    3. Place the certificate in the directory where the PolarDB Agent LakeBase binary is located.

      Note

      When PolarDB Agent LakeBase is mounted with ca.pem, make sure that SSL is enabled in the console.

    Mount

    Run the following command to mount PolarDB Agent LakeBase. Replace the placeholders in the command with your actual values.

    Note

    You must run the mount command as the root user or another account with FUSE mount permissions.

    Placeholder

    Description

    <META_URL>

    Find the MetaURL on the Basic Information page of your PolarDB Agent LakeBase instance.

    <MOUNT_POINT>

    The directory for the mount point. For example, /lakebase-data.

    <SUB_DIR>

    Optional. The relative or absolute path to a subdirectory within the LakeBase root directory. For example, a/b/c or /a/b/c. This mounts the specified subdirectory to <MOUNT_POINT>. If you do not specify this parameter, the LakeBase root directory is mounted.

    sudo ./lakebase-client-latest mount <META_URL> <MOUNT_POINT> --subdir=<SUB_DIR> -d
    Note

    If you do not need to mount a subdirectory, remove the --subdir=<SUB_DIR> parameter. In this case, all directories and files in the LakeBase root directory are visible in the current environment.

    Verify the mount

    After the mount completes, access the specified mount point to verify that you can read data from PolarDB Agent LakeBase.

    ls <MOUNT_POINT>