S3 and SMB/CIFS access
LeilFS is a POSIX filesystem. To expose it as S3 object storage or as an SMB/CIFS share, run a gateway on a node that has LeilFS mounted: mount LeilFS with leil-mount (or via the NFS‑Ganesha FSAL), then run the gateway daemon on top of the mount point. There is no LeilFS‑native S3 or SMB daemon — these protocols are layered on the filesystem.
S3 gateway
Any S3‑compatible gateway can serve a LeilFS mount, for example:
- MinIO — run in gateway/filesystem mode over the mount point
- Rclone (
rclone serve s3) - S3QL
Mount LeilFS first, then point the gateway's data directory at the mount:
sudo leil-mount /mnt/client -H 192.168.10.10
# then start your chosen S3 gateway with its backing directory set to /mnt/client
The S3 gateway handles the object protocol, authentication and bucket semantics; LeilFS provides durable, replicated POSIX storage underneath.
SMB/CIFS via Samba
Mount LeilFS with leil-mount, then share the mount point with Samba. Standard Samba configuration applies:
# /etc/samba/smb.conf (minimal example)
[leilfs-share]
path = /mnt/client/shared
read only = no
browseable = yes
valid users = @smbusers
Reload Samba after editing (sudo systemctl reload smbd), then connect from SMB clients as usual.
Run the gateway on a host with a stable, low‑latency connection to the cluster, and size it like any LeilFS client — see Performance tuning for client cache and readahead settings that affect gateway throughput.