---
name: "valkey-benchmark"
section: "1"
platform: "linux"
package: "valkey-tools"
version: "8.1.1+dfsg1-3+deb13u2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/valkey-benchmark"
---

# valkey-benchmark(1)

Benchmark a Valkey instance

## NAME

valkey-benchmark - Benchmark a Valkey instance

## SYNOPSIS

**valkey-benchmark** \[-h \<host\>\] \[-p \<port\>\] \[-c \<clients\>\] \[-n \<requests\]\> \[-k \<boolean\>\]

## DESCRIPTION

Valkey is a key-value database. It is similar to memcached but the dataset is not volatile and other datatypes (such as lists and sets) are natively supported.

## OPTIONS

- \-h hostname

  Server hostname (default 127.0.0.1)

- \-p port

  Server port (default 6379)

- \-s socket

  Server socket (overrides host and port)

- \-a password

  Password for Valkey Auth

- \-c clients

  Number of parallel connections (default 50)

- \-n requests

  Total number of requests (default 100000)

- \-d size

  Data size of SET/GET value in bytes (default 2)

- \-dbnum db

  SELECT the specified db number (default 0)

- \-k boolean

  1=keep alive 0=reconnect (default 1)

- \-r keyspacelen

  Use random keys for SET/GET/INCR, random values for SADD Using this option the benchmark will get/set keys in the form mykey\_rand000000012456 instead of constant keys, the \<keyspacelen\> argument determines the max number of values for the random number. For instance if set to 10 only rand000000000000 - rand000000000009 range will be allowed.

- \-P numreq

  Pipeline \<numreq\> requests. Default 1 (no pipeline).

- \-q

  Quiet. Just show query/sec values

- \--csv

  Ourput in CSV format

- \-l

  Loop. Run the tests forever

- \-I

  Idle mode. Just open N idle connections and wait.

- \-D

  Debug mode. more verbose.

## AUTHOR

**valkey-benchmark** was written by Salvatore Sanfilippo.

This manual page was written by Chris Lamb \<lamby@debian.org\> for the Debian project (but may be used by others).