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

In Files

  • webrick/httpservlet/filehandler.rb


Serves a directory including fancy indexing and a variety of other options.


server.mount '/assets', WEBrick::FileHandler, '/path/to/assets'

Public Class Methods

add_handler(suffix, handler) click to toggle source

Allow custom handling of requests for files with suffix by class handler

               # File webrick/httpservlet/filehandler.rb, line 162
def self.add_handler(suffix, handler)
  HandlerTable[suffix] = handler
new(server, root, options={}, default=Config::FileHandler) click to toggle source

Creates a FileHandler servlet on server that serves files starting at directory root

options may be a Hash containing keys from WEBrick::Config::FileHandler or true or false.

If options is true or false then :FancyIndexing is enabled or disabled respectively.

               # File webrick/httpservlet/filehandler.rb, line 183
def initialize(server, root, options={}, default=Config::FileHandler)
  @config = server.config
  @logger = @config[:Logger]
  @root = File.expand_path(root)
  if options == true || options == false
    options = { :FancyIndexing => options }
  @options = default.dup.update(options)
remove_handler(suffix) click to toggle source

Remove custom handling of requests for files with suffix

               # File webrick/httpservlet/filehandler.rb, line 169
def self.remove_handler(suffix)

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