Specification Limits
File System Limits
Below are the theoretical limits for JuiceFS.
- Directory tree depth: Unlimited
- File name length: 255 bytes
- Symbolic link length: 4,096 bytes
- Number of hard links:
2^31(2,147,483,648). Creating a large number of hard links can significantly impact performance and is therefore not recommended; using symbolic links is recommended instead. - Number of files in a single directory:
2^31(2,147,483,648). In practice, it is not recommended to store an extremely large number of files in a single flat directory (lsmay be very slow). - Single file size:
2^(26+31)(128 PiB) - Number of files: 100 million for JuiceFS Cloud Service. The Cloud Service uses a single-zone architecture by default, with a default limit of 100 million files. To store more files, please contact Juicedata engineers. For on-premises deployments, the metadata service can be scaled to a multi-zone architecture, supporting up to hundreds of billions of files.
- Data volume: 4 EiB
- Number of volumes: 300 by default. To increase this limit, please contact Juicedata engineers.

