Scroll to navigation



HTTPDirFS - filesystem client for HTTP directory listing


httpdirfs [options] URL mountpoint


HTTPDirFS is program that can be used to mount HTTP directory listings (generated using an Apache DirectoryIndex, for example) as a virtual filesystem through the FUSE interface. It supports HTTP basic authentication and proxy.


General options:

mount options
print help
print version

HTTPDirFS options:

HTTP authentication username
HTTP authentication password
Proxy for libcurl, for more details refer to
Username for the proxy
Password for the proxy
Enable cache (default: off)
Set a custom cache location (default: "${XDG_CACHE_HOME}/httpdirfs")
Set cache download segment size, in MB (default: 8) Note: this setting is ignored if previously cached data is found for the requested file.
Set maximum number of download segments a file can have. (default: 128*1024) With the default setting, the maximum memory usage per file is 128KB. This allows caching files up to 1TB in size using the default segment size.
Set maximum number of network connections that libcurl is allowed to make. (default: 10)
Set delay in seconds before retrying an HTTP request after encountering an error. (default: 5)
Set user agent string (default: "HTTPDirFS")

FUSE options:

enable debug output (implies -f)
foreground operation
disable multi-threaded operation
allow access to other users
allow access to root
auto unmount on process termination
allow mounts over non-empty file/dir

-o default_permissions enable permission checking by kernel

set filesystem name
set filesystem type
issue large read requests (2.4 only)
set maximum size of read requests
immediate removal (don't hide files)
let filesystem set inode numbers
try to fill in d_ino in readdir
use direct I/O
cache files in kernel
enable caching based on modification times (off)
set file permissions (octal)
set file owner
set file group
cache timeout for names (1.0s)
cache timeout for deleted names (0.0s)
cache timeout for attributes (1.0s)
auto cache timeout for attributes (attr_timeout)
never forget cached inodes
remember cached inodes for T seconds (0s)
don't supply path if not necessary
allow requests to be interrupted
signal to send on interrupt (10)
names of modules to push onto filesystem stack
set maximum size of write requests
set maximum readahead
set number of maximum background requests
set kernel's congestion threshold
perform reads asynchronously (default)
perform reads synchronously
enable atomic open+truncate support
enable larger than 4kB writes
disable remote file locking
disable remote file locking (BSD)

-o no_remote_posix_lock disable remove file locking (POSIX)

use splice to write to the fuse device
move data while splicing to the fuse device
use splice to read from the fuse device

Module options:


original encoding of file names (default: UTF-8)
new encoding of the file names (default: ANSI_X3.4-1968)


prepend this directory to all paths (mandatory)
transform absolute symlinks to relative


HTTPDirFS has been written by Fufu Fang <>.

This manpage was written by Jerome Charaoui <> for the Debian GNU/Linux distribution (but it may be used by others).

August 2019 HTTPDirFS version 1.1.10