TL;DR — Resumen Rápido
Valkey es el fork open source de Redis bajo la Linux Foundation. Instálalo, migra sin perder datos y configura clústeres y Sentinel con esta guía.
Valkey es el fork open source de Redis bajo la Linux Foundation, creado tras el cambio de licencia de Redis Ltd en marzo de 2024. Si ejecutas Redis en producción y quieres mantenerte en un almacén de clave-valor verdaderamente open source con gobernanza comunitaria, esta guía te lleva a través de la instalación, migración desde Redis sin pérdida de datos, y operación de clústeres y Sentinel.
Por Qué Existe Valkey
Redis fue BSD desde 2009 hasta principios de 2024. El 20 de marzo de 2024, Redis Ltd relicenció Redis bajo un modelo dual SSPL/RSAL — ninguna de las dos licencias está aprobada por la OSI, lo que significa que Redis ya no es open source según la definición estándar. Proveedores de nube y contribuidores hicieron fork de la última versión con licencia BSD (7.2.4) en cuestión de días.
La Linux Foundation aceptó el fork como Valkey en abril de 2024, respaldado por Amazon Web Services, Google Cloud, Oracle, Ericsson, Snap y numerosos contribuidores individuales.
Requisitos Previos
- Servidor Linux con Ubuntu 22.04+, Debian 12+, RHEL 9+, o cualquier distro moderna.
- Instalación existente de Redis 6.x o 7.x (si migras).
- Acceso
sudoo root. - Docker (opcional, para la ruta de contenedor).
Instalación de Valkey
apt (Debian/Ubuntu)
curl -fsSL https://packages.valkey.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/valkey.gpg
echo "deb [signed-by=/usr/share/keyrings/valkey.gpg] https://packages.valkey.io/apt stable main" \
| sudo tee /etc/apt/sources.list.d/valkey.list
sudo apt update && sudo apt install -y valkey
dnf (RHEL/Fedora/Rocky Linux)
sudo dnf install -y https://packages.valkey.io/rpm/valkey-release-latest.rpm
sudo dnf install -y valkey
Docker
docker run -d \
--name valkey \
-p 6379:6379 \
-v valkey-data:/data \
valkey/valkey:latest valkey-server --save 60 1 --loglevel warning
Migración de Redis a Valkey
Valkey lee directamente los archivos RDB y AOF de Redis — no se requiere conversión.
Paso 1: Guardar y Respaldar Datos de Redis
redis-cli SAVE
sudo cp -r /var/lib/redis /var/lib/redis-backup
Paso 2: Detener Redis
sudo systemctl stop redis-server
sudo systemctl disable redis-server
Paso 3: Configurar Valkey
sudo cp /etc/redis/redis.conf /etc/valkey/valkey.conf
sudo sed -i 's|^dir .*|dir /var/lib/redis|' /etc/valkey/valkey.conf
valkey.conf usa sintaxis idéntica a redis.conf. Cada directiva — bind, requirepass, maxmemory, políticas de desalojo, TLS, RDB, AOF — funciona sin cambios.
Paso 4: Iniciar Valkey y Verificar
sudo systemctl enable valkey-server
sudo systemctl start valkey-server
valkey-cli PING # → PONG
valkey-cli DBSIZE # verificar conteo de claves
Paso 5: Actualizar Cadenas de Conexión
Cambia host: redis a host: valkey (o la nueva IP/hostname). No se necesitan otros cambios de código.
Referencia de Configuración
| Directiva | Ejemplo | Propósito |
|---|---|---|
bind | bind 127.0.0.1 ::1 | Direcciones de escucha |
requirepass | requirepass s3cr3t | Autenticación por contraseña |
maxmemory | maxmemory 2gb | Límite de memoria |
maxmemory-policy | allkeys-lru | Política de desalojo |
save | save 900 1 | Programa de snapshots RDB |
appendonly | appendonly yes | Activar AOF |
Nuevas Características de Valkey
Valkey incluye mejoras no presentes en Redis OSS:
- Transporte RDMA — Remote Direct Memory Access para clústeres de latencia ultra baja (Valkey 8.0+).
- Dict por slot en modo clúster — Cada uno de los 16,384 slots de hash obtiene su propio diccionario, reduciendo la contención de bloqueos.
- Replicación de doble canal — Canal dedicado para transferencia de datos masiva y otro para streaming de comandos en vivo.
- Mayor eficiencia de memoria — Menor sobrecarga por clave vs Redis 7.2.
Clúster de Valkey
El Clúster Valkey usa el mismo modelo de 16,384 slots de hash que Redis Cluster. Las herramientas existentes funcionan sin cambios.
# Crear clúster de 6 nodos (3 primarios + 3 réplicas)
valkey-cli --cluster create \
192.168.1.1:7000 192.168.1.2:7001 192.168.1.3:7002 \
192.168.1.4:7003 192.168.1.5:7004 192.168.1.6:7005 \
--cluster-replicas 1
# Verificar estado del clúster
valkey-cli --cluster check 192.168.1.1:7000
Sentinel para Alta Disponibilidad
# /etc/valkey/sentinel.conf
sentinel monitor mymaster 192.168.1.1 6379 2
sentinel auth-pass mymaster s3cr3t
sentinel down-after-milliseconds mymaster 5000
sentinel failover-timeout mymaster 60000
valkey-sentinel /etc/valkey/sentinel.conf
Docker Compose con Sentinel
services:
valkey-primary:
image: valkey/valkey:latest
command: valkey-server --requirepass ${VALKEY_PASSWORD} --appendonly yes
volumes:
- valkey-primary-data:/data
networks: [valkey-net]
valkey-replica:
image: valkey/valkey:latest
command: >
valkey-server
--replicaof valkey-primary 6379
--requirepass ${VALKEY_PASSWORD}
--masterauth ${VALKEY_PASSWORD}
volumes:
- valkey-replica-data:/data
networks: [valkey-net]
depends_on: [valkey-primary]
valkey-sentinel:
image: valkey/valkey:latest
command: valkey-sentinel /etc/valkey/sentinel.conf
configs:
- source: sentinel-conf
target: /etc/valkey/sentinel.conf
networks: [valkey-net]
volumes:
valkey-primary-data:
valkey-replica-data:
networks:
valkey-net:
configs:
sentinel-conf:
content: |
sentinel monitor mymaster valkey-primary 6379 1
sentinel auth-pass mymaster ${VALKEY_PASSWORD}
sentinel down-after-milliseconds mymaster 5000
Valkey vs Redis y Alternativas
| Característica | Valkey | Redis OSS | Redis Enterprise | KeyDB | Dragonfly |
|---|---|---|---|---|---|
| Licencia | BSD 3-Clause | SSPL/RSAL | Propietaria | BSD | BSL 1.1 |
| Gobernanza | Linux Foundation | Redis Ltd | Redis Ltd | Snap Inc | Dragonfly DB |
| Compat. Redis | Total (7.2) | Nativa | Total | Total | Alta |
| Clúster | Sí | Sí | Sí | Sí | Sí |
| RDMA | Sí (v8+) | No | Parcial | No | No |
| Costo | Gratis | Gratis | Pago | Gratis | Gratis (núcleo) |
Resumen
- Valkey es el fork con licencia BSD y gobernanza de Linux Foundation de Redis 7.2 — compatible como reemplazo directo.
- La migración es directa: detén Redis, apunta Valkey al directorio de datos existente, inicia Valkey.
- Todos los clientes Redis se conectan a Valkey sin cambios de código — solo cambia el hostname.
- Clúster y Sentinel usan configuración y herramientas idénticas a Redis.
- Nuevas características en Valkey 8+ mejoran el rendimiento más allá de Redis 7.2.