Skip to content
Percona Documentation

Rate this page
☆ ☆ ☆ ☆ ☆
Thanks for your feedback
Thank you! The feedback has been submitted.

Get free database assistance or contact our experts for personalized support.

Get help from Percona

Install Valkey from Percona repositories

Percona provides Valkey packages for the following Linux distributions:

  • Oracle Linux 8, Rocky Linux 8, and Alma Linux 8
  • Oracle Linux 9, Rocky Linux 9, and Alma Linux 9
  • Oracle Linux 10, Rocky Linux 10, and Alma Linux 10
  • Amazon Linux 2023
  • Ubuntu 22.04
  • Ubuntu 24.04
  • Ubuntu 26.04
  • Debian 11
  • Debian 12
  • Debian 13

The packages are available for x86_64 and ARM64 architectures.

Prerequisites

  1. To install Valkey, you need access to the Percona repositories. Use the percona-release repository management tool to enable the required repository.
  2. Both Valkey and Redis use the same libraries 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 you install Valkey.

Install Valkey

Run the following commands as a root user or with sudo.

  1. 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 can access the Percona repositories.

  2. Enable the repository: 

    $ sudo percona-release enable valkey-91 release

  3. Remember to update the local cache: 

    $ sudo apt update

  4. Install Valkey:

    $ sudo apt install percona-valkey-server

  1. Install percona-release:

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

  2. Enable the repository:

    $ sudo percona-release enable valkey-91 release

  3. Install Valkey:

    $ sudo yum install percona-valkey

  4. Start the Valkey service:

    $ sudo systemctl start valkey

  5. Check the Valkey service:

    $ sudo systemctl status valkey

Connect to Valkey

Use valkey-cli to connect to the Valkey server.

Check the connection:

$ valkey-cli ping
PONG

Run valkey-cli without any argument to start interactive mode:

$ valkey-cli
127.0.0.1:6379>

For information about Valkey, see the Valkey documentation website.

For information about Valkey commands, see the Valkey command reference.