Valkey Management
Valkey is a high-performance, non-relational key-value database. It stores data in memory, which enables very fast request processing.
Unlike relational database management systems, Valkey doesn't have traditional databases and tables—data is organized into keyspaces, and values can take different structures and types, including strings, lists, sets, and hash tables.
Valkey is an open-source fork of Redis. It maintains compatibility with the Redis protocol, commands, and client libraries, so you can use familiar tools, SDKs, and drivers to connect to a cluster. In most cases, applications that worked with Redis can work with Valkey without any code changes.
Valkey is commonly used for:
- Data caching
- Session storage
- Queue management
- Messaging between services
- Real-time data processing
When creating a cluster, you can choose a Valkey version: 7, 8.1, or 9.1.
Users and Privileges Copy link
In your Hostman dashboard, you can manage Valkey users and their privileges.
Creating Users Copy link
- Go to the Databases section and click on the cluster.
- Open the Users tab and click Add.
- Set the username and password:
- Username: 3–64 characters. Letters, numbers, and special characters are allowed.
- Password: 8–30 characters. Letters, numbers, and special characters are allowed.
- (Optional) Configure the user’s privileges. You can also leave the default parameters and change them later at any time.
- Click Create.
Modifying Privileges Copy link
To update the privileges of an existing user:
- Go to the Databases section and click on the cluster.
- Open the Users tab.
- Click the three dots next to the user.
- Select Privileges.
- Choose the required privileges. You can grant access to a specific database or grant the same privileges for all databases by enabling Identical for all databases in the top right.
Available Privileges Copy link
|
Privilege |
Description |
|
|
Read data from the database. |
|
|
Write and modify data. |
|
|
Run administrative commands (e.g., manage configuration, flush database). |
|
|
Work with bit arrays. |
|
|
Use blocking commands (e.g., |
|
|
Manage connections and connection settings. |
|
|
Access potentially dangerous commands (e.g., |
|
|
Work with geospatial data (e.g., |
|
|
Work with hash tables. |
|
|
Work with the |
|
|
Use low-latency commands. |
|
|
Get key lists and key metadata. |
|
|
Work with lists. |
|
|
Use the publish/subscribe mechanism ( |
|
|
Execute Lua scripts in Valkey. |
|
|
Work with sets. |
|
|
Work with sorted sets. |
|
|
Use commands that may take longer to execute. |
|
|
Work with data streams ( |
|
|
Work with strings. |
|
|
Use transactions ( |
Changing User Password Copy link
You can change the user password:
- Go to the Database section and click on the cluster.
- Go to the Users tab.
- Click the three dots next to the user.
- Select Change password.
- Enter a new value and save changes.
Database Parameters Copy link
You can change database settings to optimize its performance.
By default, the database is created with the parameters that are suitable for most tasks and will ensure the performance of the selected configuration. However, if your project requires specific settings, you can change them as you wish.
Be careful and change parameters only if you are sure of their purpose. Incorrect configuration can negatively affect the operation of the database and its performance.
Changing Parameters Copy link
- Go to the Databases section and click on the cluster.
- Go to the Configuration tab.
- Click Modify parameters next to Database parameters.
- Adjust the parameters. To read more about each parameter, click Open description next to it.
- Click Apply at the bottom of the page.
Parameters List Copy link
|
Parameter |
Valid Values |
Default Value |
|
— |
0 0 0 |
|
|
— |
33554432 8388608 60 |
|
|
— |
allkeys-lru |
|
|
0–600000000 |
10000 |
|
|
0–4294967296 |
128 |
|
|
0–3600000000 |
0 |
|
|
0–2147483647 |
16 |
|
|
— |
900 1 |
|
|
On/Off |
On |
|
|
— |
everysec |
|
|
0–3600 |
300 |
|
|
— |
— |
Connecting to the Database Copy link
To work with your Valkey cluster, install the redis-cli or valkey-cli utility. Valkey is compatible with Redis, so you can connect using either standard Redis clients and commands or Valkey tools.
Installing redis-cli Copy link
The redis-cli utility is included with Redis and can be installed via package managers:
- Ubuntu/Debian
sudo apt install redis-tools- macOS
brew install redis- Arch Linux
sudo pacman -S redis- CentOS/RHEL
sudo yum install redisAfter installation, check the client version:
redis-cli -vInstalling valkey-cli Copy link
To use valkey-cli, install the Valkey package. This will also install the command-line utility:
- Ubuntu/Debian
sudo apt install valkey- macOS
brew install valkey- Arch Linux
sudo pacman -Syu valkey- CentOS/RHEL
sudo yum install epel-release
sudo yum install valkeyConnection Command Copy link
There are two ways to connect to a Valkey cluster:
- via public IP;
- via private IP.
You can copy the connection command from:
-
the Dashboard tab:
-
the Connection tab:
Creating a Dump Copy link
Valkey is compatible with Redis, so you can use most existing tools from the Redis ecosystem for backup and migration.
To export Valkey data, use the redis-dump-go utility, available for different architectures. Download the binary for your architecture from the official repository.
To create a dump, run:
REDISDUMPGO_AUTH='password' ./redis-dump-go -host <cluster-ip> -port 6379 -user default > redis-dump.txtHere, REDISDUMPGO_AUTH is the password for cluster access.
Importing a Dump Copy link
To import data, use redis-cli or valkey-cli in --pipe mode, which supports loading large datasets:
redis-cli -h <cluster-ip> -p 6379 --user default --pass 'password' --pipe < redis-dump.txtOr with valkey-cli:
valkey-cli -h IP-адрес-кластера -p 6379 --user default --pass 'пароль' --pipe < redis-dump.txt