Performance Tuning - Storj Docs

There are many variables to consider when optimizing Object Mount for the best performance, including:

Operating System behavior
Connection Speed
Storage Provider Characteristics

The sections below will provide tips on optimization for each of these three areas, tailored for your specific environment.

Operating System Tips

Use a recent kernel (5.10+ preferred) for improved FUSE performance.
Ensure fuse3 and required kernel modules are installed.
Run Object Mount as a systemd user service if automatically mounting on login.
Place cache directories (data cache, metadata cache) on a fast, local SSD or NVMe volume.
Adjust ulimit -n if handling many open files (e.g. ulimit -n 65535).

Connection Speed Tips

Object Mount adapts well to different network conditions, but optimal performance depends on the speed and reliability of your connection to cloud storage.

10 Gbps or faster

Increase S3 connections limit (e.g. 200+).
If Client and Storage are on the same Local Area Network (LAN), disable Data cache.
Consider setting metadata cache timeout to a lower value for frequent sync.

Storage Provider Tips

Each storage backend behaves slightly differently depending on API responsiveness, region latency, and compatibility mode.

Set an appropriate region to avoid cross-region latency.
Use multipart uploads for large file writes (default behavior in Object Mount).
Enable caching and proxy workflows for high-resolution media.
Monitor AWS rate limits if using a high connection pool size.