wbox man page

wbox — HTTP testing tool and configuration-less HTTP server


wbox <url> [ options ]
wbox servermode webroot <path> [serverport <portnumber> (def 8081)]


wbox aims to help you having fun while testing HTTP related stuff. You can use it to perform many tasks, including the following:

- Benchmarking how much time it takes to generate content for your web application.

- Web server and web application stressing.

- Testing virtual domains configuration without the need to alter your local resolver.

- Use it as a configuration-less HTTP server to share files!


Stop after <number> requests
Send Accept-Encoding: gzip,deflate in request
Show the HTTP reply header
Show the HTTP reply header + body
Don't show status lines
Use the HEAD method instead of GET
Use HTTP/1.0 instead of HTTP/1.1
Close the connection after reading few bytes
host <hostname>
Use <hostname> as Host: field in HTTP request
Show transfer times for different data chunks
wait <number>
Wait <number> seconds between requests. Default 1.
clients <number>
Spawn <number> concurrent clients (via fork()).
referer <url>
Send the specified referer header.
cookie <name> <val>
Set cookie name=val, can be used multiple times.
maxclients <number>
Max concurrent clients in server mode (default 20).
-h or --help
Show this help.
Show version.

Usage Examples

wbox wikipedia.org (simplest, basic usage)

wbox wikipedia.org 3 compr wait 0 (three requests, compression, no delay)

wbox wikipedia.org 1 showhdr silent (just show the HTTP reply header)

wbox wikipedia.org timesplit (show splitted time information)

wbox host example.domain (test a virtual domain at

wbox servermode webroot /tmp/mydocuments (Try it with


Wbox is trivial to use but, in order to understand better what wbox is and how to use it, you may want to read the Tutorial inside the /usr/share/doc/wbox/ directory.


wbox was written by Salvatore 'antirez' Sanfilippo <antirez@gmail.com>.

This manual page was written by Alberto Furia <straluna@email.it>, for the Debian project (and may be used by others).


December 10, 2009