# juicedata/juicefs

JuiceFS is a distributed POSIX file system built on top of Redis and S3.

Repository: https://github.com/juicedata/juicefs
Canonical: https://ross.abutalabs.com/products/juicefs
Homepage: https://juicefs.com
Language: Go
License: Apache-2.0
License Family: permissive
Topics: filesystem, cloud-native, golang, redis, distributed-systems, storage, object-storage, posix, hdfs, s3, bigdata, go
Last push: 2026-08-26T09:25:24+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 96, longevity 100
- inputs: {"age_days": 2063, "days_push": 7, "days_rel": 26, "gap_med": 19, "n_releases_24m": 14}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 14358, forks 1279 (observed 2026-08-28T04:11:06.852378+00:00)

## What it is
JuiceFS is a high-performance, POSIX-compatible distributed file system that stores file data in object storage (e.g., Amazon S3) and metadata in databases such as Redis, MySQL, TiKV, or PostgreSQL. It is designed for cloud-native environments, offering FUSE mounting, an S3 gateway, a Hadoop Java SDK, and a Kubernetes CSI driver.

## Use cases
- mount s3 object storage as a local posix filesystem
- shared storage for kubernetes pods via csi driver
- replace hdfs for hadoop big data workloads
- shared file storage for machine learning training data
- store billions of files cheaply on object storage
- multi-cloud and hybrid cloud file storage
- s3-compatible gateway over a mounted filesystem

## When to choose
- you need a fully POSIX-compatible shared filesystem backed by cheap object storage
- you want strong consistency across thousands of concurrent clients
- you run Kubernetes and need persistent shared volumes
- you want HDFS or S3 protocol compatibility without running a full storage cluster
- you need high metadata performance with Redis, TiKV, or a database as the metadata engine

## When to avoid
- you need a single-node filesystem with no distributed requirements
- you cannot operate an external metadata engine like Redis or MySQL
- you need block storage or raw device access rather than file storage
- you require fully offline operation with no object storage backend
- you need a self-contained storage cluster like Ceph that manages its own disks

## Facets
- artifact type: application
- maturity: stable
- function: file-system, object-storage, caching, cli, self-hosted
- domain: microservices, cloud-computing, big-data, infrastructure-as-code, files
- platform: windows, go, self-hosted, cloud
- tags: fuse, posix-filesystem, s3-gateway, csi-driver, hadoop-sdk, metadata-engine, object-storage-backed, containers, linux, macos, docker, kubernetes

## Member repositories
- juicedata/juicefs (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:06.852378+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:12:38.115690+00:00, confidence not recorded.
  - readme: https://github.com/juicedata/juicefs (fetched 2026-08-28T04:11:06.852378+00:00, sha 1da09ce42ee8)
  - homepage: https://juicefs.com (fetched 2026-08-29T08:06:14.342008+00:00, sha 337bb2bd0684)
  - site_page: https://juicefs.com/docs/community/introduction (fetched 2026-08-29T08:06:14.345360+00:00, sha 7611a3150af5)
  - site_page: https://juicefs.com/docs/cloud (fetched 2026-08-29T08:06:14.347734+00:00, sha a58bf0cbac80)
  - site_page: https://juicefs.com/docs/csi/introduction (fetched 2026-08-29T08:06:14.349640+00:00, sha 91500390be45)
  - site_page: https://juicefs.com/en/about-us (fetched 2026-08-29T08:06:14.353929+00:00, sha e16231b91be6)
  - site_page: https://juicefs.com/docs/community/how_to_use_on_kubernetes (fetched 2026-08-29T08:06:14.355803+00:00, sha 22b74a8b0ea9)
  - site_page: https://juicefs.com/docs/community/comparison/juicefs_vs_cephfs (fetched 2026-08-29T08:06:14.358278+00:00, sha 93ed55efbf94)
  - site_page: https://juicefs.com/docs/community/comparison/juicefs_vs_alluxio (fetched 2026-08-29T08:06:14.360129+00:00, sha 1c9f53904e81)
  - site_page: https://juicefs.com/en/pricing (fetched 2026-08-29T08:06:14.351862+00:00, sha 7b93b80d62d3)
- Data as of 2026-08-30T08:39:29.467469+00:00.