How to Connect

Connecting with Node.js

This guide explains how to establish a connection between a Node.js application and a Valkey database using the redis package. It walks through the necessary setup, configuration, and execution of a simple Valkey command.

Variables

To successfully connect to a Valkey instance, you’ll need to provide the following parameters. These can typically be found on the Elestio service overview page.

Variable

Description

Purpose

HOST

Valkey hostname (from Elestio service overview)

The address of the server hosting your Valkey instance.

PORT

Valkey port (from Elestio service overview)

The port used for the Valkey connection. The default Valkey port is 6379.

PASSWORD

Valkey password (from Elestio service overview)

Authentication key used to connect securely to the Valkey instance.

These values can usually be found in the Elestio service overview details as shown in the image below, make sure to take a copy of these details and add it to the code moving ahead.

Screenshot 2025-07-04 at 4.12.37 PM.jpg

Prerequisites

Install Node.js and NPM

node -v
npm -v

Install the redis Package

The redis package enables communication between Node.js applications and Valkey.

npm install redis --save

Code

Create a new file named valkey.js and add the following code:

const valkey = require("redis");

// Valkey connection configuration
const config = {
  socket: {
    host: "HOST",
    port: PORT,
  },
  password: "PASSWORD",
};

// Create a Redis client
const client = valkey.createClient(config);

// Handle connection errors
client.on("error", (err) => {
  console.error("Valkey connection error:", err);
});

// Connect and run a test command
(async () => {
  try {
    await client.connect();
    console.log("Connected to Valkey");

    // Set and retrieve a test key
    await client.set("testKey", "Hello Valkey");
    const value = await client.get("testKey");
    console.log("Retrieved value:", value);

    // Disconnect from Valkey
    await client.disconnect();
  } catch (err) {
    console.error("Valkey operation failed:", err);
  }
})();

To execute the script, open the terminal or command prompt and navigate to the directory where valkey.js is located. Once in the correct directory, run the script with the command:

node valkey.js

If the connection is successful, the output should resemble:

Connected to Valkey  
Retrieved value: Hello Valkey

Connecting with Python

This guide explains how to connect a Python application to a Valkey database using the redis library. It walks through the required setup, configuration, and execution of a simple Valkey command.

Variables

To connect to Valkey, the following parameters are needed. You can find these values in the Elestio Valkey service overview.

Variable

Description

Purpose

HOST

Valkey hostname (from Elestio service overview)

Address of the Valkey server.

PORT

Valkey port (from Elestio service overview)

Port used to connect to Valkey. The default is 6379.

PASSWORD

Valkey password (from Elestio service overview)

Authentication credential for the Valkey connection.

These values can usually be found in the Elestio service overview details as shown in the image below, make sure to take a copy of these details and add it to the code moving ahead.

Screenshot 2025-07-04 at 4.12.37 PM.jpg

Prerequisites

Install Python and pip

python3 --version
pip --version

Install the redis Package

Install the official redis library using pip:

pip install redis

Code

Create a file named valkey.py and paste the following code:

import redis

config = {
    "host": "HOST",
    "port": PORT,  # Example: 6379
    "password": "PASSWORD",
    "decode_responses": True
}

try:
    client = redis.Redis(**config)
    client.set("testKey", "Hello Valkey")
    value = client.get("testKey")
    print("Connected to Valkey")
    print("Retrieved value:", value)

except redis.RedisError as err:
    print("Valkey connection or operation failed:", err)

To execute the script, open the terminal or command prompt and navigate to the directory where valkey.py is located. Once in the correct directory, run the script with the command:

python3 redis.py

If everything is set up correctly, the output will be:

Connected to Valkey  
Retrieved value: Hello Valkey

Connecting with PHP

This guide explains how to establish a connection between a PHP application and a Valkey database using the phpredis extension. It walks through the necessary setup, configuration, and execution of a simple Valkey command.

Variables

Certain parameters must be provided to establish a successful connection to a Valkey database. Below is a breakdown of each required variable, its purpose, and where to find it. Here’s what each variable represents:

Variable

Description

Purpose

HOST

Valkey hostname, from the Elestio service overview page

The address of the server hosting your Valkey instance.

PORT

Port for Valkey connection, from the Elestio service overview page

The network port used to connect to Valkey. The default port is 6379.

PASSWORD

Valkey password, from the Elestio service overview page

The authentication key required to connect securely to Valkey.

These values can usually be found in the Elestio service overview details as shown in the image below. Make sure to take a copy of these details and add it to the code moving ahead.

Screenshot 2025-07-04 at 4.12.37 PM.jpg

Prerequisites

php -v
sudo pecl install redis
extension=redis
php -m | grep redis

Code

Once all prerequisites are set up, create a new file named valkey.php and add the following code:

<?php

$host = 'HOST';
$port = PORT;
$password = 'PASSWORD';

$valkey = new Redis();

try {
    $valkey->connect($host, $port);

    if (!$valkey->auth($password)) {
        throw new Exception('Authentication failed');
    }

    echo "Connected to Valkey\n";

    $valkey->set("testKey", "Hello Valkey");
    $value = $valkey->get("testKey");
    echo "Retrieved value: $value\n";

    $valkey->close();

} catch (Exception $e) {
    echo "Valkey connection or operation failed: " . $e->getMessage() . "\n";
}

Open the terminal or command prompt and navigate to the directory where valkey.php is located. Once in the correct directory, run the script with the command:

php valkey.php

If the connection is successful, the terminal will display output similar to:

Connecting with Go

This guide explains how to establish a connection between a Go application and a Valkey database using the go-redis package. It walks through the necessary setup, configuration, and execution of a simple Valkey command.

Variables

Certain parameters must be provided to establish a successful connection to a Valkey database. Below is a breakdown of each required variable, its purpose, and where to find it. Here’s what each variable represents:

Variable

Description

Purpose

HOST

Valkey hostname, from the Elestio service overview page

The address of the server hosting your Valkey instance.

PORT

Port for Valkey connection, from the Elestio service overview page

The network port used to connect to Valkey. The default port is 6379.

PASSWORD

Valkey password, from the Elestio service overview page

The authentication key required to connect securely to Valkey.

These values can usually be found in the Elestio service overview details as shown in the image below, make sure to take a copy of these details and add it to the code moving ahead.

Screenshot 2025-07-04 at 4.12.37 PM.jpg

Prerequisites

Install Go

Check if Go is installed by running:

go version

If not installed, download it from golang.org and install.

Install the go-redis Package

The go-redis package enables Go applications to interact with Valkey. Install it using:

go get github.com/redis/go-redis/v9

Code

Once all prerequisites are set up, create a new file named valkey.go and add the following code:

package main

import (
	"context"
	"fmt"
	"time"

	"github.com/redis/go-redis/v9"
)

func main() {
	opt := &redis.Options{
		Addr:     "HOST:PORT",     
		Password: "PASSWORD",      
		DB:       0,           
	}

	valkey := redis.NewClient(opt)
	ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
	defer cancel()

	err := valkey.Set(ctx, "testKey", "Hello Valkey", 0).Err()
	if err != nil {
		fmt.Println("Valkey operation failed:", err)
		return
	}

	val, err := valkey.Get(ctx, "testKey").Result()
	if err != nil {
		fmt.Println("Valkey operation failed:", err)
		return
	}

	fmt.Println("Connected to Valkey")
	fmt.Println("Retrieved value:", val)

	if err := valkey.Close(); err != nil {
		fmt.Println("Error closing connection:", err)
	}
}

To execute the script, open the terminal or command prompt and navigate to the directory where valkey.go is located. Once in the correct directory, run the script with the command:

go run valkey.go

If the connection is successful, the terminal will display output similar to:

Connected to Valkey  
Retrieved value: Hello Valkey

Connecting with Java

This guide explains how to establish a connection between a Java application and a Valkey database using the Jedis library. It walks through the necessary setup, configuration, and execution of a simple Valkey command.

Variables

Certain parameters must be provided to establish a successful connection to a Valkey database. Below is a breakdown of each required variable, its purpose, and where to find it. Here’s what each variable represents:

Variable

Description

Purpose

HOST

Valkey hostname, from the Elestio service overview page

The address of the server hosting your Valkey instance.

PORT

Port for Valkey connection, from the Elestio service overview page

The network port used to connect to Valkey. The default port is 6379.

PASSWORD

Valkey password, from the Elestio service overview page

The authentication key required to connect securely to Valkey.

These values can usually be found in the Elestio service overview details as shown in the image below, make sure to take a copy of these details and add it to the code moving ahead.

Screenshot 2025-07-04 at 4.12.37 PM.jpg

Prerequisites

Install Java

Check if Java is installed by running:

java -version

If not installed, download it from oracle.com and install.

Download Jedis and Dependencies

The Jedis library enables Java applications to interact with Valkey. You need to download two JAR files manually:

  1. Jedis JAR (Jedis 5.1.0):

    https://repo1.maven.org/maven2/redis/clients/jedis/5.1.0/jedis-5.1.0.jar

  2. Apache Commons Pool2 JAR (Required by Jedis):

    https://repo1.maven.org/maven2/org/apache/commons/commons-pool2/2.11.1/commons-pool2-2.11.1.jar

Place both JAR files in the same directory as your Java file.

Code

Once all prerequisites are set up, create a new file named Valkey.java and add the following code:

import redis.clients.jedis.JedisPooled;

public class Valkey {
    public static void main(String[] args) {
        String host = "HOST";
        int port = PORT; // e.g., 6379
        String password = "PASSWORD";

        JedisPooled jedis = new JedisPooled(host, port, password);

        try {
            jedis.set("testKey", "Hello Valkey");
            String value = jedis.get("testKey");

            System.out.println("Connected to Valkey");
            System.out.println("Retrieved value: " + value);

        } catch (Exception e) {
            System.out.println("Valkey connection or operation failed: " + e.getMessage());
        }
    }
}

To execute the script, open the terminal or command prompt and navigate to the directory where Valkey.java is located. Once in the correct directory, run the following commands:

On Linux/macOS :

javac -cp "jedis-5.1.0.jar:commons-pool2-2.11.1.jar" Valkey.java
java -cp ".:jedis-5.1.0.jar:commons-pool2-2.11.1.jar" Valkey

On Windows :

javac -cp "jedis-5.1.0.jar;commons-pool2-2.11.1.jar" Valkey.java
java -cp ".;jedis-5.1.0.jar;commons-pool2-2.11.1.jar" Valkey

If the connection is successful, the terminal will display output similar to:

Connected to Valkey  
Retrieved value: Hello Valkey

Connecting with RedisInsight

This guide explains how to establish a connection between RedisInsight and a Valkey database instance. It walks through the necessary setup, configuration, and connection steps using the official Redis GUI.

Variables

Certain parameters must be provided to establish a successful connection to a Valkey database. Below is a breakdown of each required variable, its purpose, and where to find it. Here’s what each variable represents:

Variable

Description

Purpose

HOST

Valkey hostname, from the Elestio service overview page

The address of the server hosting your Valkey instance.

PORT

Port for Valkey connection, from the Elestio service overview page

The network port used to connect to Valkey. The default port is 6379.

PASSWORD

Valkey password, from the Elestio service overview page

The authentication key required to connect securely to Valkey.

These values can usually be found in the Elestio service overview details as shown in the image below, make sure to take a copy of these details and add it to the tool moving ahead.

Screenshot 2025-07-04 at 4.12.37 PM.jpg

Prerequisites

Install RedisInsight

RedisInsight is a graphical tool for managing Redis databases. Download and install RedisInsight from:

https://redis.com/redis-enterprise/redis-insight/

RedisInsight is available for Windows, macOS, and Linux.

Steps

Once all prerequisites are set up, follow these steps to connect:

  1. Launch RedisInsight

    Open the RedisInsight application after installation.

  2. Add a New Valkey Database

    Click on “Add Valkey Database”.

  3. Enter Your Connection Details

    Fill in the following fields using your Elestio Valkey service information:

    • Host: HOST

    • Port: PORT

    • Password: PASSWORD

     

    image.png

  4. Test and Save the Connection

    Click on “Test Connection” to verify the details. If successful, click “Connect” or “Add Database”.

If the connection is successful, RedisInsight will display a dashboard showing key metrics, data structures, memory usage, and allow you to interact directly with Valkey using a built-in CLI or visual browser.

Connecting with keydb-cli

This guide explains how to establish a connection between valkey-cli and a Valkey database instance. It walks through the necessary setup, configuration, and execution of a simple Valkey command from the terminal.

Variables

Certain parameters must be provided to establish a successful connection to a Valkey database. Below is a breakdown of each required variable, its purpose, and where to find it. Here’s what each variable represents:

Variable

Description

Purpose

HOST

Valkey hostname, from the Elestio service overview page

The address of the server hosting your Valkey instance.

PORT

Port for Valkey connection, from the Elestio service overview page

The network port used to connect to Valkey. The default port is 6379.

PASSWORD

Valkey password, from the Elestio service overview page

The authentication key required to connect securely to Valkey.

These values can usually be found in the Elestio service overview details as shown in the image below. Make sure to take a copy of these details and use them in the command moving ahead.

Screenshot 2025-07-04 at 4.12.37 PM.jpg

Prerequisites

Install valkey-cli

Check if valkey-cli is installed by running:

valkey-cli --version

If not installed, you can install it via:

brew install valkey
sudo apt-get install valkey-tools

Use Windows Subsystem for Linux (WSL) or download the CLI binaries from the Valkey GitHub releases page.

Command

Once all prerequisites are set up, open the terminal or command prompt and run the following command:

valkey-cli -h HOST -p PORT -a PASSWORD

Replace HOST, PORT, and PASSWORD with the actual values from your Elestio Valkey service.

If the connection is successful, the terminal will display a Valkey prompt like this:

127.0.0.1:6379>

Test the Connection

You can then run a simple command to test the connection:

set testkey "Hello Valkey"
get testkey

Expected output:

OK
"Hello Valkey"

If the connection is successful, the terminal will display output similar to the above.