NAME

       nghttpd - HTTP/2 server

SYNOPSIS

       nghttpd [OPTION]... <PORT> [<PRIVATE_KEY> <CERT>]

DESCRIPTION

       HTTP/2 server

       <PORT> Specify listening port number.

       <PRIVATE_KEY>
              Set  path  to  server's private  key.   Required  unless --no-tls is specified.

       <CERT> Set  path  to  server's  certificate.   Required  unless --no-tls is specified.

OPTIONS

       -a, --address=<ADDR>
              The  address  to  bind  to.   If not specified the default IP address determined by
              getaddrinfo is used.

       -D, --daemon
              Run in a background.  If -D is used, the current working directory is   changed  to
              '/'.  Therefore  if this option is used, -d option must be specified.

       -V, --verify-client
              The  server  sends a client certificate  request.  If the client did  not return  a
              certificate,  the   handshake  is  terminated.    Currently,   this   option   just
              requests  a client certificate and does not verify it.

       -d, --htdocs=<PATH>
              Specify  document  root.  If this option is not specified, the document root is the
              current working directory.

       -v, --verbose
              Print debug information  such as reception/ transmission of frames  and  name/value
              pairs.

       --no-tls
              Disable SSL/TLS.

       -c, --header-table-size=<SIZE>
              Specify decoder header table size.

       --color
              Force colored log output.

       -p, --push=<PATH>=<PUSH_PATH,...>
              Push   resources <PUSH_PATH>s  when <PATH>  is requested.  This option  can be used
              repeatedly  to specify multiple push  configurations.    <PATH>  and   <PUSH_PATH>s
              are relative  to   document  root.   See   --htdocs  option.  Example: -p/=/foo.png
              -p/doc=/bar.css

       -b, --padding=<N>
              Add at  most <N>  bytes to a  frame payload  as  padding.   Specify  0  to  disable
              padding.

       -m, --max-concurrent-streams=<N>
              Set the maximum number of  the concurrent streams in one HTTP/2 session.

              Default: 100

       -n, --workers=<N>
              Set the number of worker threads.

              Default: 1

       -e, --error-gzip
              Make error response gzipped.

       --dh-param-file=<PATH>
              Path  to  file that contains  DH parameters in PEM format.  Without  this   option,
              DHE   cipher  suites   are  not available.

       --early-response
              Start sending response when request  HEADERS  is  received,  rather  than  complete
              request is received.

       --trailer=<HEADER>
              Add  a  trailer   header  to  a response.   <HEADER> must not include pseudo header
              field  (header field name starting with ':').  The  trailer  is  sent  only  if   a
              response has body part.  Example: --trailer 'foo: bar'.

       --hexdump
              Display  the   incoming  traffic in  hexadecimal (Canonical hex+ASCII display).  If
              SSL/TLS  is used, decrypted data are used.

       --echo-upload
              Send back uploaded content if method is POST or PUT.

       --mime-types-file=<PATH>
              Path  to file  that contains  MIME media  types and  the extensions that  represent
              them.

              Default: /etc/mime.types

       --no-content-length
              Don't send content-length header field.

       --version
              Display version information and exit.

       -h, --help
              Display this help and exit.

       The  <SIZE>  argument  is an integer and an optional unit (e.g., 10K is 10 * 1024).  Units
       are K, M and G (powers of 1024).

SEE ALSO

       nghttp(1), nghttpx(1), h2load(1)

AUTHOR

       Tatsuhiro Tsujikawa

COPYRIGHT

       2012, 2015, 2016, Tatsuhiro Tsujikawa