Install Valkey from Percona repositories¶

Valkey offers packages for a select number of Linux distributions. Specifically, you can install it from Fedora/EPEL yum repositories and as binary tarballs for both Ubuntu Bionic and Ubuntu Focal. Additionally, it is available as a Docker container.

To support Valkey’s development and adoption, Percona provides packages for all major active Linux distributions, making it easy for you to install Valkey on your system.

The packages are available for both x86_64 and ARM64 architectures for the following operating systems:

Oracle Linux 8, Rocky Linux 8 and Alma Linux 8
Oracle Linux 9, Rocky Linux 9 and Alma Linux 9
Ubuntu 20.04
Ubuntu 22.04
Ubuntu 24.04
Debian 11
Debian 12

Preconditions¶

To install the software, you will need to subscribe to Percona repositores. To do this, use the percona-release repository management tool that automatically enables the necessary repository. The software and all required dependencies are available in this repository, saving you from resolving dependency conflicts during the installation process.
Both Valkey and Redis use the same libs that conflict with each other when you try to install Valkey on the same host with Redis. Therefore, either install Valkey on another host or remove Redis first before Valkey installation.

Install Valkey¶

Install on Debian / UbuntuInstall on Oracle Linux

Run the following command as a root user or using the sudo privileges.

Install percona-release:

a. Fetch percona-release packages from Percona web:
```
$ wget https://repo.percona.com/apt/percona-release_latest.$(lsb_release -sc)_all.deb
```
b. Install the downloaded package with dpkg:
```
$ sudo dpkg -i percona-release_latest.$(lsb_release -sc)_all.deb
```
After you install this package, you have the access to Percona repositories. You can check the repository setup in the /etc/apt/sources.list.d/percona-prel-release.list file.

Enable the repository:

$ sudo percona-release enable valkey testing

Remember to update the local cache:
```
$ sudo apt update
```
Install Valkey
```
$ sudo apt install valkey
```

Install percona-release

$ sudo yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm

Enable the repository

$ sudo percona-release enable valkey testing

Install Valkey
```
$ sudo yum install valkey
```
Upon installation, Valkey is not started automatically. To start it, run the following command:
```
$ sudo systemctl start valkey
```
Check Valkey’s status:
```
$ sudo systemctl status valkey
```

Connect to Valkey¶

With Valkey up and running, you can now connect to it using the valkey-cli interface. Check if Valkey is correctly running by passing the following command:

$ valkey-cli ping
PONG

You can pass valkey-cli without any argument. You should see the following prompt:

127.0.0.1:6379>

This way you connect to Valkey in interactive mode.

Get expert help¶

If you need assistance, visit the community forum for comprehensive and free database knowledge, or contact our Percona Database Experts for professional support and services.

Community Forum Get a Percona Expert