Maintenance of Ruby 2.0.0 will end on February 24, 2016. Read more

In Files

  • webrick/config.rb
  • webrick/https.rb
  • webrick/ssl.rb





Default configuration for WEBrick::HTTPAuth::BasicAuth


Reload the user database provided by :UserDB automatically?


Default configuration for WEBrick::HTTPAuth::DigestAuth.


MD5, MD5-sess (default), SHA1, SHA1-sess


An Array of URIs that define the protected space


‘auth’ for authentication, ‘auth-int’ for integrity protection or both


Should the server send opaque values to the client? This helps prevent replay attacks.


Should the server check the nonce count? This helps the server detect replay attacks.


Should the server send an AuthenticationInfo header?


Reload the user database provided by :UserDB automatically?


How long should we store used nonces? Default is 30 minutes.


How long is a nonce valid? Default is 1 minute


Hack which allows Internet Explorer to work.


Hack which allows Opera to work.


Default configuration for WEBrick::HTTPServlet::FileHandler


Array of languages allowed for accept-language. There is no default


Allows preprocessing of directory requests. There is no default callback.


If true, show an index for directories. The default is true.


Allows preprocessing of file requests. There is no default callback.


Allows preprocessing of requests. There is no default callback.


Maps file suffixes to file handlers. DefaultFileHandler is used by default but any servlet can be used.


Do not show files matching this array of globs. .ht* and *~ are excluded by default.


Directory inside ~user to serve content from for /~user requests. Only works if mounted on /. Disabled by default.


for GenericServer


for HTTPServer, HTTPRequest, HTTPResponse


Default SSL server configuration.

WEBrick can automatically create a self-signed certificate if :SSLCertName is set. For more information on the various SSL options see OpenSSL::SSL::SSLContext.


The server software name used in the Server: header.



Enable SSL for this server.  Defaults to false.

The SSL certificate for the server.


The SSL private key for the server certificate.



Array of certificates that will be sent to the client.


Array of certificates that willbe added to the certificate chain


Path to a CA certificate file


Path to a directory containing CA certificates


OpenSSL::X509::Store used for certificate validation of the client


Callback invoked when DH parameters are required.

Sets whether the client is verified. This defaults to VERIFY_NONE which is typical for an HTTPS server.


Number of CA certificates to walk when verifying a certificate chain


Custom certificate verification callback


Maximum session lifetime


Various SSL options


Immediately start SSL upon connection? Defaults to true


SSL certificate name. Must be set to enable automatic certificate creation.


Comment used during automatic certificate creation.

Commenting is here to help enhance the documentation. For example, code samples, or clarification of the documentation.

If you have questions about Ruby or the documentation, please post to one of the Ruby mailing lists. You will get better, faster, help that way.

If you wish to post a correction of the docs, please do so, but also file bug report so that it can be corrected for the next release. Thank you.

If you want to help improve the Ruby documentation, please visit

blog comments powered by Disqus