If you’re new to Redis Enterprise Cloud, this quick start helps you get up and running.

You’ll learn how to:

  1. Create an account, a free subscription, and a database

  2. Connect to your database

If you already have an account, see Create a Fixed subscription to create a Free 30MB subscription. Free plans are a tier of fixed plans; this provides an easy upgrade path when you need it.

If you already have a subscription, see Manage subscriptions and Manage databases.

Create an account

To create a new account with a free subscription and database:

  1. On the Redis Cloud admin console, select Sign up.

  2. Enter your information in the form and select Get Started, or sign up with Google or Github.

  3. In the activation email, select Activate account to go to the Redis Cloud admin console.

    Dialog to create your free subscription.
  4. Select your preferred cloud vendor and region.

  5. Select Let’s start free to create your subscription and database.

    Note:
    If you would rather customize your subscription and database, select Create a custom database to go to the Add subscription page. From there, you can create a fixed subscription or create a flexible subscription.

    You’re taken to the Overview tab for your new subscription.

    Overview tab showing your new subscription and database.
  6. Select the database name to view the Configuration tab for your new database.

    Configuration tab showing details of your new database.

    In the upper corner, an icon shows the current status of the database. If the icon shows an orange clock, this means your database is still being created and its status is pending.

    Pending status icon   Active status icon

    Once the database has been created, it becomes active and the status indicator switches to a green circle containing a checkmark.

Admin console operations are asynchronous; they operate in the background. You can continue to use the admin console for other tasks, but pending resources aren’t available until they’re active.

When your new database becomes active, you’re ready to connect to it.

Connect to a database

At this point, you’re viewing the Configuration details for your new database.

To connect to your database, you need your username and password. For the default user, the username is default.

The Security section contains your Default user password. By default, this is masked. Select the eye icon to show or hide the password.

The Security section of the Configuration tab of the database details page.

Once you have the username and password, select Connect to open the connection wizard.

Connect button

The connection wizard provides the following database connection methods:

The connection wizard.

redis-cli (via Docker)

The redis-cli utility is installed when you install Redis. It provides a command-line interface that lets you work with your database using core Redis commands.

Docker provides a convenient way to run redis-cli without the full installation experience.

Run the following commands to create a redis Docker container and connect to your database with redis-cli:

  1. Download the redis Docker image:

    $ docker pull redis
    
  2. Start a container created from the image:

    $ docker run -d --name redis1 redis
    
  3. Connect to a bash prompt running in the container:

    $ docker exec -it redis1 bash
    
  4. In the connection wizard, under Redis CLI, select the Copy button to copy the redis-cli command.

  5. Enter the copied redis-cli command in the terminal and replace <username> and <password> with your username and password.

  6. After you connect to your database, try these basic Redis commands:

    xxx:yyy> ping
    PONG
    xxx:yyy> set hello world
    OK
    xxx:yyy> get hello
    "world"
    

    To try other Redis commands, see the commands reference for help.

Redis client

Different programming languages use different connection clients to interact with Redis databases, and each client has its own syntax and installation process. For help with a specific client, see the client’s documentation.

The connection wizard provides code snippets to connect to your database with the following programming languages:

See the client list to view all Redis clients by language.

Code example (Python)

To connect to your database using the redis-py library for Python:

  1. Install the Redis client if it is not already installed.

    $ sudo pip install redis
    
  2. In the connection wizard, under Redis Client, select Python from the Select your client menu.

  3. Select Copy to copy the connection code for your database.

  4. Add the copied code to your program and replace <username> and <password> with your username and password.

    import redis
    
    r = redis.Redis(
      host='<host>',
      port=<port>,
      password='<password>')
    
    # Redis commands
    r.set('hello', 'world')
    print(r.get('hello'))
    
  5. Run the program.

    $ python example_redis.py
    world
    

RedisInsight

RedisInsight is a free Redis GUI that is available for MacOS, Windows, and Linux.

  1. In the connection wizard, under Redis Client, select your operating system from the Download RedisInsight menu.

  2. Select Download to download RedisInsight.

  3. Install RedisInsight.

  4. Open RedisInsight and select Add Redis Database.

  5. In the connection wizard, under RedisInsight Desktop, select Copy to copy the connection information.

  6. In RedisInsight, enter the copied connection information into the Host field. RedisInsight automatically populates the rest of the fields needed to connect to the database as the default user.

  7. Select Add Redis Database to connect to the database.

See the RedisInsight documentation for more information.

More info