---
name: "httpdirfs"
section: "1"
platform: "linux"
package: "httpdirfs"
version: "1.2.7-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/httpdirfs"
---

# httpdirfs(1)

"mount HTTP directory as a virtual filesystem"

## NAME

HTTPDirFS - "mount HTTP directory as a virtual filesystem"

## DESCRIPTION

usage: */build/reproducible-path/httpdirfs-fuse-1.2.7/obj-x86\_64-linux-gnu/httpdirfs* \[options\] URL mountpoint

### general options:

- **--config**

  Specify a configuration file

- **-o** opt,\[opt...\]

  Mount options

- **-h** **--help**

  Print help

- **-V** **--version**

  Print version

### 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

- **--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 specifid with \`--cache-location\`, if the option is seen first. Then exit in either case.

- **--cacert**

  Certificate authority 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-seg-count**

  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.

- **--max-conns**

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

- **--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)

- **--user-agent**

  Set user agent string (default: "HTTPDirFS")

- **--no-range-check**

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

- **--insecure-tls**

  Disable licurl TLS certificate verification by setting CURLOPT\_SSL\_VERIFYHOST to 0

- **--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

error: no mountpoint specified

libcurl SSL engine: OpenSSL/3.5.0 On calling fusermount posix\_spawn failed: No such file or directory Running 'fusermount3 **--version**' failedFUSE library version 3.17.1 using FUSE kernel interface version 7.40

## SEE ALSO

The full documentation for **HTTPDirFS** is maintained as a Texinfo manual.  If the **info** and **HTTPDirFS** programs are properly installed at your site, the command

-

  **info HTTPDirFS**

should give you access to the complete manual.