Install dependencies (probably in a venv):
pip3 install -r requirements.txt
Run python3 mount.py
The image derkades/tahoe-mount and derkades/tahoe-upload is available on Docker Hub. Please note that mounting filesystems from docker containers is usually not a great idea, for production use please install packages on your host system instead.
The package tahoe-mount is available in my repository. If you run into missing dependency issues on older Debian/Ubuntu versions, use the tahoe-mount-static version instead (amd64 only).
To build these packages locally, run ./build-deb.sh.
- Listing files and directories
- Deleting (unlinking) files and directories
- Reading files (unlike tahoe's SFTP system, doesn't need to download the entire file)
- Creating directories
- Creating files
- Writing to files (broken due to tahoe bug, see below)
- Due to severe file corruption bugs in the Tahoe-LAFS REST API when writing to MDMF/SDMF mutable files, the file system won't allow writes (not even without
ro). To upload files, use my related project tahoe-upload. - Mtime/ctime/crtime is not set properly. This will be addressed soon.
mount.tahoe <root cap> <mountpoint> -o <options>
Options:
| name | value | description |
|---|---|---|
node_url |
string, standard url format | Tahoe-LAFS node web API URL (REQUIRED) |
setuid |
int | User id which all files and directories in the filesystem should be owned by. Defaults to the user running the mount command (usually root). |
setgid |
int | Group id, see above |
file_mode |
int | Permission mode for files (default 644) |
dir_mode |
int | Permission mode for directories (default 755) |
ro |
none | Make filesystem read-only |
allow_other |
none | Sets the FUSE allow_other option |
debug |
none | Enables application debug logging |
debug_fuse |
none | Enables FUSE debug logging |
fork |
none | Fork before entering main filesystem loop, required for use in /etc/fstab |
nofork |
none | Do not fork, see above (default) |
syslog |
none | Log to syslog, instead of stdout |
Example (foreground):
mount.tahoe -o node_url=http://localhost:3456,file_mode=444,dir_mode=555,ro,allow_other,nofork URI:DIR2:... /mnt/tahoe
mount -t tahoe -o node_url=http://localhost:3456,file_mode=444,dir_mode=555,ro,allow_other,nofork URI:DIR2:... /mnt/tahoe
fstab:
URI:DIR2:... /mnt/tahoe tahoe node_url=http://localhost:3456,file_mode=444,dir_mode=555,ro,allow_other,fork,syslog
Note: If you installed tahoe-mount-static instead of tahoe-mount, the /usr/sbin/mount.tahoe mount helper program is not directly executable but a symlink. This doesn't seem to work with with mount and fstab and procudes an unknown filesystem type 'tahoe' error. As a workaround, use fuse./usr/lib/tahoe-mount/tahoe-mount as the filesystem type instead of tahoe.