Skip to content

valkey #235

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Apr 10, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions apps/docs/content/homepage.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -44,12 +44,12 @@ export const containers = [
export const databases = [
{ name: "PostgreSQL", link: "/postgresql/overview", icon: <Icons.postgresql/> },
{ name: "MariaDB", link: "/mariadb/overview", icon: <Icons.mariadb/> },
{ name: "KeyDB", link: "/keydb/overview", icon: <Icons.keydb/> },
{ name: "Valkey", link: "/valkey/overview", icon: <Icons.valkey/> },
{ name: "Elasticsearch", link: "/elasticsearch/overview", icon: <Icons.elasticsearch/> },
{ name: "Typesense", link: "/typesense/overview", icon: <Icons.typesense/> },
{ name: "Meilisearch", link: "/meilisearch/overview", icon: <Icons.meilisearch/> },
{ name: "Qdrant", link: "/qdrant/overview", icon: <Icons.qdrant/> },
{ name: "Valkey", icon: <Icons.valkey/> },
{ name: "KeyDB", link: "/keydb/overview", icon: <Icons.keydb/> },
{ name: "Kafka", icon: <Icons.kafka/> },
{ name: "NATS", icon: <Icons.nats/> },
]
Expand Down
67 changes: 67 additions & 0 deletions apps/docs/content/valkey/overview.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
---
title: Valkey
desc: Production-ready Valkey on Zerops platform with managed infrastructure and automatic security configuration. Deploy and run your in-memory data store with zero operational overhead.
---

import UnorderedList from '@site/src/components/UnorderedList';
import UnorderedCodeList from '@site/src/components/UnorderedCodeList';
import data from '@site/static/data.json';

Valkey is a powerful, open-source alternative to Redis, offering full compatibility with Redis clients while providing an independent development path focused on community-driven innovation. Deploy and manage Valkey on Zerops' fully managed infrastructure to get instant access to high-performance in-memory data storage.

:::tip
Valkey is our recommended Redis alternative as KeyDB's development has slowed significantly in recent times.
:::

## Supported Versions

Currently supported Valkey versions:
<UnorderedList data={data.valkey.readable}/>

Import configuration version:
<UnorderedCodeList data={data.valkey.import}/>

## Service Configuration

Zerops offers Valkey in two deployment configurations to meet different availability requirements.

## Deployment Options

### Non-HA Setup
- Single node deployment on port `6379` (non-TLS) and `6380` (TLS)
- No backup mechanism beyond Zerops infrastructure reliability
- Data persists unless the hardware node fails
- Suitable for development or non-critical workloads

### HA (High Availability) Setup

Our HA implementation uses a unique approach to ensure high availability while maintaining compatibility with all Redis clients:

- 3-node configuration (1 master + 2 replicas)
- Access ports:
- `6379` - read/write operations (non-TLS, routed to master)
- `6380` - read/write operations over TLS (routed to master)
- `7000` - read-only operations (non-TLS)
- `7001` - read-only operations over TLS
- Implementation details:
- All nodes are configured identically and listen on standard ports
- First node in the cluster is designated as the master
- On replica nodes, ports `6379`/`6380` traffic is forwarded to the master
- Ports `7000`/`7001` are mapped locally to each node for direct replica access
- When a master fails, a replica is promoted and routing is updated automatically
- DNS entries are updated for seamless client connection
- This implementation provides traffic forwarding to master (not natively supported by Valkey)

:::note
Be aware that replica data may lag slightly behind the master due to asynchronous replication.
:::

## Learn More

- [Official Valkey Documentation](https://valkey.io/docs) - Comprehensive guide to Valkey features

## Support

For advanced configurations or custom requirements:
- Join our [Discord community](https://discord.gg/zerops)
- Contact support via [email](mailto:support@zerops.io)
48 changes: 34 additions & 14 deletions apps/docs/sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -363,13 +363,13 @@ module.exports = {
className: 'homepage-sidebar-item service-sidebar-item',
},
{
type: 'ref',
id: 'keydb/overview',
label: 'KeyDB (Redis)',
type: "ref",
id: "valkey/overview",
label: "Valkey (Redis)",
customProps: {
sidebar_icon: 'keydb',
sidebar_icon: "valkey",
},
className: 'homepage-sidebar-item service-sidebar-item',
className: "homepage-sidebar-item service-sidebar-item",
},
{
type: "ref",
Expand Down Expand Up @@ -407,15 +407,15 @@ module.exports = {
},
className: "homepage-sidebar-item service-sidebar-item",
},
// {
// type: "ref",
// id: "valkey/overview",
// label: "Valkey",
// customProps: {
// sidebar_icon: "valkey",
// },
// className: "homepage-sidebar-item service-sidebar-item",
// },
{
type: 'ref',
id: 'keydb/overview',
label: 'KeyDB',
customProps: {
sidebar_icon: 'keydb',
},
className: 'homepage-sidebar-item service-sidebar-item',
},
// {
// type: "ref",
// id: "kafka/overview",
Expand Down Expand Up @@ -2234,6 +2234,26 @@ module.exports = {
},
},
],
valkey: [
{
type: 'ref',
id: 'homepage',
label: 'Back to home',
customProps: {
sidebar_is_back_link: true,
sidebar_icon: 'back-arrow',
},
},
{
type: 'doc',
id: 'valkey/overview',
label: 'Zerops Valkey Service',
customProps: {
sidebar_is_title: true,
sidebar_icon: 'valkey',
},
},
],
qdrant: [
{
type: 'ref',
Expand Down
Loading