Skip to main content

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 (ls may 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.