Updated on 2024-05-20 GMT+08:00

Connecting to an Instance Using a Private Domain Name

This section describes how to connect to a GeminiDB Redis instance using a private domain name on a Linux ECS.


  • The instances must be in the same VPC and subnet as the ECS.
  • The ECS must be in a security group that has access to the instances.

    Scenario 1: If the instance is associated with the default security group, you do not need to configure security group rules.

    Scenario 2: If the instance is not associated with the default security group, check whether the security group rules allow the ECS to connect to the instance.

    • If yes, the ECS can connect to the instance.
    • If no, add an inbound rule to the security group.

      For details about how to configure a security group, see Configuring Security Group Rules.



  1. Configure the private domain name for the GeminiDB Redis instance. For details, see Configuring a Private Domain Name.
  2. Log in to the ECS. For details, see Logging In to an ECS in Getting Started with Elastic Cloud Server.
  3. Obtain the Redis client.

    Method 1

    Run the following command to download the Redis client.

    wget http://download.redis.io/releases/redis-6.2.0.tar.gz

    Method 2

    Download the Redis client from the address provided in Prerequisites and upload the Redis client installation package to the ECS.

  4. Decompress the client tool package.

    tar -xzf redis-6.2.0.tar.gz

  5. Connect to the DB instance in the src directory.

    cd redis-6.2.0


    cd src

    ./redis-cli -h <DB_Domain_Name> -p <DB_PORT> -a <DB_PWD>


    ./redis-cli -h redis.com -p 8635 -a <DB_PWD>

    Table 1 Parameter description




    The private domain name of the DB instance to be connected. The private domain name is the one created in 1.


    Port for accessing the target instance. Configure this parameter based on service requirements.

    To obtain the instance port number, perform the following steps:

    Click the target instance to go to the Basic Information page. In the Network Information area, you can find the database port.


    Specifies the administrator password set when you buy a GeminiDB Redis instance.

  6. Check the results. If the following information is displayed, the connection is successful.