httpdirfs - Man Page

"mount HTTP directory as a virtual filesystem"

Description

general options

--config

Specify a configuration file

-o opt,[opt...]

Mount options

-h  --help

Print help

-V  --version

Print version

-f

Foreground operation

-s

Disable multi-threaded operation

-d  --debug

Enable debug output (implies -f)

HTTPDirFS options

-u  --username

HTTP authentication username

-p  --password

HTTP authentication password

-P  --proxy

Proxy for libcurl, for more details refer to https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html

--proxy-username

Username for the proxy

--proxy-password

Password for the proxy

--proxy-cacert

Certificate authority for the proxy

--proxy-capath

Certificate authority directory for the proxy

--cache

Enable cache (default: off)

--cache-location

Set a custom cache location (default: "${XDG_CACHE_HOME}/httpdirfs")

--cache-clear

Delete the cache directory or the custom location specified with `--cache-location`, if the option is seen first. Then exit in either case.

--cache-min-size

Set minimum file size threshold for caching, in bytes (default: none)

--cache-max-size

Set maximum file size threshold for caching, in bytes (default: none)

--cacert

Certificate authority for the server

--capath

Certificate authority directory for the server

--dl-seg-size

Set cache download segment size, in MB (default: 8) Note: this setting is ignored if previously cached data is found for the requested file.

--http-header

Set one or more HTTP headers

--max-conns

Set maximum number of network connections that libcurl is allowed to make. (default: 6)

--refresh-timeout

The directories are refreshed after the specified time, in seconds (default: 3600)

--retry-wait

Set delay in seconds before retrying an HTTP request after encountering an error. (default: 5)

--invalid-refresh

Try refreshing invalid links when reading a directory.

--user-agent

Set user agent string (default: "HTTPDirFS-1.3.3")

--no-range-check

Disable the built-in check for the server's support for HTTP range requests

--zero-len-is-dir

If a file has a zero length, treat it as a directory

--insecure-tls

Disable libcurl TLS certificate verification by setting CURLOPT_SSL_VERIFYHOST to 0

--external-links

Include external (cross-origin) links from directory listings (default: off)

--single-file-mode

Single file mode - rather than mounting a whole directory, present a single file inside a virtual directory.

For mounting a Airsonic / Subsonic server:

--sonic-username

The username for your Airsonic / Subsonic server

--sonic-password

The password for your Airsonic / Subsonic server

--sonic-id3

Enable ID3 mode - this present the server content in Artist/Album/Song layout

--sonic-insecure

Authenticate against your Airsonic / Subsonic server using the insecure username / hex encoded password scheme

usage: /builddir/build/BUILD/httpdirfs-1.3.3-build/httpdirfs-1.3.3/redhat-linux-build/httpdirfs [options] <mountpoint>

FUSE options

-h   --help

print help

-V   --version

print version

-d   -o debug

enable debug output (implies -f)

-f

foreground operation

-s

disable multi-threaded operation

-o clone_fd

use separate fuse device fd for each thread (may improve performance)

-o max_idle_threads

the maximum number of idle worker threads allowed (default: -1)

-o max_threads

the maximum number of worker threads allowed (default: 10)

-o kernel_cache

cache files in kernel

-o [no]auto_cache

enable caching based on modification times (off)

-o no_rofd_flush

disable flushing of read-only fd on close (off)

-o umask=M

set file permissions (octal)

-o fmask=M

set file permissions (octal)

-o dmask=M

set dir  permissions (octal)

-o uid=N

set file owner

-o gid=N

set file group

-o entry_timeout=T

cache timeout for names (1.0s)

-o negative_timeout=T

cache timeout for deleted names (0.0s)

-o attr_timeout=T

cache timeout for attributes (1.0s)

-o ac_attr_timeout=T

auto cache timeout for attributes (attr_timeout)

-o noforget

never forget cached inodes

-o remember=T

remember cached inodes for T seconds (0s)

-o modules=M1[:M2...]

names of modules to push onto filesystem stack

-o allow_other

allow access by all users

-o allow_root

allow access by root

-o auto_unmount

auto unmount on process termination

-o io_uring

enable io-uring

-o io_uring_q_depth=<n> io-uring queue depth

Options for subdir module

-o subdir=DIR

prepend this directory to all paths (mandatory)

-o [no]rellinks

transform absolute symlinks to relative

Options for iconv module

-o from_code=CHARSET

original encoding of file names (default: UTF-8)

-o to_code=CHARSET

new encoding of the file names (default: UTF-8)

libcurl SSL engine: OpenSSL/4.0.2 Failed to call 'fusermount3': No such file or directory Running 'fusermount3 --version' failedFUSE library version 3.18.3 using FUSE kernel interface version 7.45

Info

September 2026 HTTPDirFS version 1.3.3