OS Manuals

/usr/bin/hey

HTTP load generator, ApacheBench (ab) replacement

From hey 0.1.5-r16 (os), captured 2026-11-05 by running hey --help (exit 0). permalink

Usage: hey [options...] <url>

Options:
  -n  Number of requests to run. Default is 200.
  -c  Number of workers to run concurrently. Total number of requests cannot
      be smaller than the concurrency level. Default is 50.
  -q  Rate limit, in queries per second (QPS) per worker. Default is no rate limit.
  -z  Duration of application to send requests. When duration is reached,
      application stops and exits. If duration is specified, n is ignored.
      Examples: -z 10s -z 3m.
  -o  Output type. If none provided, a summary is printed.
      "csv" is the only supported alternative. Dumps the response
      metrics in comma-separated values format.

  -m  HTTP method, one of GET, POST, PUT, DELETE, HEAD, OPTIONS.
  -H  Custom HTTP header. You can specify as many as needed by repeating the flag.
      For example, -H "Accept: text/html" -H "Content-Type: application/xml" .
  -t  Timeout for each request in seconds. Default is 20, use 0 for infinite.
  -A  HTTP Accept header.
  -d  HTTP request body.
  -D  HTTP request body from file. For example, /home/user/file.txt or ./file.txt.
  -T  Content-type, defaults to "text/html".
  -U  User-Agent, defaults to version "hey/0.0.1".
  -a  Basic authentication, username:password.
  -x  HTTP Proxy address as host:port.
  -h2 Enable HTTP/2.

  -host	HTTP Host header.

  -disable-compression  Disable compression.
  -disable-keepalive    Disable keep-alive, prevents re-use of TCP
                        connections between different HTTP requests.
  -disable-redirects    Disable following of HTTP redirects
  -cpus                 Number of used cpu cores.
                        (default for current machine is 64 cores)
Options (20)
OptionDescriptionSource
-nNumber of requests to run.help
-cNumber of workers to run concurrently.help
-qRate limit, in queries per second (QPS) per worker.help
-zDuration of application to send requests.help
-oOutput type.help
-mHTTP method, one of GET, POST, PUT, DELETE, HEAD, OPTIONS.help
-HCustom HTTP header.help
-tTimeout for each request in seconds.help
-AHTTP Accept header.help
-dHTTP request body.help
-DHTTP request body from file.help
-TContent-type, defaults to "text/html".help
-UUser-Agent, defaults to version "hey/0.0.1".help
-aBasic authentication, username:password.help
-xHTTP Proxy address as host:port.help
-hostHTTP Host header.help
-disable-compressionDisable compression.help
-disable-keepaliveDisable keep-alive, prevents re-use of TCP connections between different HTTP requests.help
-disable-redirectsDisable following of HTTP redirectshelp
-cpusNumber of used cpu cores.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.