A userspace filesystem backing by Apache OpenDAL.

Clone this repo:
  1. 62b56fa chore(deps): bump softprops/action-gh-release (#15) by dependabot[bot] · 11 hours ago main
  2. 9683a30 chore(deps): bump the github-actions group with 3 updates (#14) by dependabot[bot] · 11 hours ago
  3. 0b0d112 RFC-0016: Define ofs filesystem architecture (#16) by Xuanwo · 4 days ago
  4. 3b1822f fix(fuse): preserve handles across flush (#18) by Xuanwo · 4 days ago
  5. f6c152c chore: remove unsupported Cloud Filter integration (#13) by Xuanwo · 4 days ago

Apache OpenDAL™ ofs

Build Status Latest Version Crate Downloads chat

ofs is a userspace filesystem backing by OpenDAL.

Status

ofs is a work in progress. we only support fs and s3 as backend on Linux currently.

How to use ofs

Install FUSE on Linux

sudo pacman -S fuse3 --noconfirm # archlinux
sudo apt-get -y install fuse3    # debian/ubuntu

Load FUSE kernel module on FreeBSD

kldload fuse

Install ofs

ofs could be installed by cargo:

cargo install ofs

cargo is the Rust package manager. cargo could be installed by following the Installation from Rust official website.

Mount directory

ofs <mount-point> 'fs://?root=<directory>'

Mount S3 bucket

ofs <mount-point> 's3://?root=<path>&bucket=<bucket>&endpoint=<endpoint>&region=<region>&access_key_id=<access-key-id>&secret_access_key=<secret-access-key>'

Branding

The first and most prominent mentions must use the full form: Apache OpenDAL™ of the name for any individual usage (webpage, handout, slides, etc.) Depending on the context and writing style, you should use the full form of the name sufficiently often to ensure that readers clearly understand the association of both the OpenDAL project and the OpenDAL software product to the ASF as the parent organization.

For more details, see the Apache Product Name Usage Guide.

License and Trademarks

Licensed under the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0

Apache OpenDAL, OpenDAL, and Apache are either registered trademarks or trademarks of the Apache Software Foundation.