wbox - Man Page

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