For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/en/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/en/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/en/guides/public-cloud/databases/valkey-advanced-parameters-references.md.

Advanced parameters for Public Cloud Databases for Valkey

View as Markdown

This guide lists all the supported advanced parameters that allow you to configure your Public Cloud Databases for Valkey according to your use cases

Objective

This guide lists all the supported advanced parameters that allow you to configure your Public Cloud Databases for Valkey according to your use cases.

Requirements

  • A Public Cloud project in your OVHcloud account
  • A database running on your OVHcloud Public Cloud Databases (this guide can help you to meet this requirement)

Instructions

Info

Advanced parameters can also be managed with Terraform, through the advanced_configuration argument (key/value pairs) of the ovh_cloud_project_database resource.

Using the OVHcloud Control Panel

Please refer to this guide to find out how to change your advanced parameters from the OVHcloud Control Panel.

Using API

Please refer to this guide to find out how to change your advanced parameters from the OVHcloud API.

Advanced parameters for Valkey

Below you can find the advanced parameters available for a Valkey service:

Info

The table below lists the advanced parameters available for a Valkey service. Your service shows the exact list, with the allowed values, in the Configuration tab of the Control Panel and through the API.

Changing the advanced configuration may cause the service to restart. This is the case for valkey_io_threads and valkey_number_of_databases: change them during a low-traffic period.

Parameters
valkey_acl_channels_default string
values: allchannels, resetchannels
Determines default pub/sub channels' ACL for new users if ACL is not supplied. When this option is not defined, allchannels is assumed to keep backward compatibility. This option doesn't affect Valkey configuration acl-pubsub-default.
valkey_active_defrag_ignore_bytes long
min: 1048576 max: 1073741824
default: 104857600
Minimum amount of fragmentation waste, in bytes, before active defragmentation starts. Only takes effect when valkey_activedefrag is enabled.
valkey_active_defrag_threshold_lower long
min: 1 max: 100
default: 10
Minimum percentage of fragmentation before active defragmentation starts. Only takes effect when valkey_activedefrag is enabled.
valkey_active_expire_effort long
min: 1 max: 10
default: 1
Valkey reclaims expired keys both when accessed and in the background. The background process scans for expired keys to free memory. Increasing the active-expire-effort setting (default 1, max 10) uses more CPU to reclaim expired keys faster, reducing memory usage but potentially increasing latency.
valkey_activedefrag boolean
default: false
Enable active memory defragmentation. When enabled, Valkey relocates objects off sparsely used memory pages to reduce fragmentation and return memory to the operating system. Defragmentation runs on the main thread and consumes CPU, so it may increase latency under load.
valkey_io_threads long
min: 1 max: 256
Set Valkey IO thread count. Changing this will cause a restart of the Valkey service.
valkey_lfu_decay_time long
min: 1 max: 120
default: 1
LFU maxmemory-policy counter decay time in minutes
valkey_lfu_log_factor long
min: 0 max: 100
default: 10
Counter logarithm factor for volatile-lfu and allkeys-lfu maxmemory-policies
valkey_maxmemory_policy string
values: allkeys-lfu, allkeys-lru, allkeys-random, noeviction, volatile-lfu, volatile-lru, volatile-random, volatile-ttl
default: noeviction
Valkey maxmemory-policy
valkey_notify_keyspace_events string
default: ""
Set notify-keyspace-events option
valkey_number_of_databases long
min: 1 max: 128
Set number of Valkey databases. Changing this will cause a restart of the Valkey service.
valkey_persistence string
values: off, rdb
Controls whether Valkey writes RDB snapshots to disk. With rdb, snapshots are written for backups. With off, no snapshot is written: backups and forking are unavailable, and all data is lost if the service restarts.
valkey_pubsub_client_output_buffer_limit long
min: 32 max: 262144
Set output buffer limit for pub/sub clients in MB. The value is the hard limit; the soft limit is 1/4 of the hard limit. When setting the limit, be mindful of the available memory in the selected service plan.
valkey_ssl boolean
default: true
Require SSL to access Valkey
valkey_timeout long
min: 0 max: 2073600
default: 300
Valkey idle connection timeout in seconds
valkey_version string
values: 8.1, 9.1
Valkey major version

Go further

Visit our dedicated Discord channel: https://discord.gg/ovhcloud. Ask questions, provide feedback and interact directly with the team that builds our databases services.

For training or technical assistance implementing our solutions, contact your sales representative or visit our Professional Services page to request a quote and have your project analysed by our experts.

Join our community of users.

Was this page helpful?