HEY(1)

📦
version 0.1.5 · 5 versions
, in ubuntu stonking

💖 HEY(1) — the hey girlies' manual 💖

Hii bestie!! So hey is a HTTP load generator, and it used to be known as rakyll/boom back in the day (glow-up era, we love a rebrand). If you wanna yeet a bunch of requests at a URL and see how it holds up, this is your queen. 👑

✨ SYNOPSIS ✨

hey [options...] <url>

That's it. Options go first, <url> goes last, and then she goes. 🏃‍♀️💨

🌸 OPTIONS 🌸

Like, so many options, and every single one of them is here, no cap:

  • -n — How many requests you wanna run. Default is 200. That's the whole vibe count.
  • -c — How many workers run concurrently. Real talk: your total number of requests cannot be smaller than the concurrency level. Default is 50 workers doing their little tasks in parallel. 🐝
  • -q — Rate limit, in queries per second (QPS) per worker. Default is no rate limit — she's unhinged, she's free. 😌
  • -z — How long the app should keep sending requests. When the duration is reached, the app stops and exits, periodt. Big caveat bestie: if duration is specified, n is ignored. Examples: -z 10s, -z 3m.
  • -o — Output type. If you don't provide one, a summary gets printed. "csv" is the only supported alternative, and it dumps the response metrics in comma-separated values format. Simple as.
  • -m — HTTP method, one of GET, POST, PUT, DELETE, HEAD, OPTIONS. Pick your fighter.
  • -H — Custom HTTP header. You can specify as many as you need by repeating the flag. For example: -H "Accept: text/html" -H "Content-Type: application/xml". Stack 'em like bracelets. 🫶
  • -t — Timeout for each request, in seconds. Default is 20. Use 0 for infinite (chaotic, iconic).
  • -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, written as username:password.
  • -x — HTTP Proxy address as host:port.
  • -h2 — Enable HTTP/2. Fancy protocol era, we stan. ✨
  • -host — HTTP Host header.
  • -disable-compression — Disable compression. Bye bye zip energy.
  • -disable-keepalive — Disable keep-alive, which prevents re-use of TCP connections between different HTTP requests. Every request gets a fresh lil connection, no sharing.
  • -disable-redirects — Disable following of HTTP redirects. (Note: no period in the original, but the drama is implied. 💀)
  • -cpus — Number of used cpu cores.
Heads up bestie: req count can't be lower than concurrency, -z totally overrides -n, and -o really only takes csv as an alternative. Don't come for me, that's just what it says. 🙈

And that's the whole page, babe — you're basically a load-testing main character now. 🎀

This was hey version 0.1.5, dated April 2026, and you read the whole thing so you're legally iconic. Go stress-test something (responsibly). 💅⭐🦋

📦 where this page comes from