cubefs /cubefs

cloud-native distributed storage

★ 5,697⑂ 716👁 102⑃ 2,888● 1,109▤ 44
GoApache-2.0Created 2019-02-19cubefs.io
Download: Release v3.6.0 - 2026/08/14Release-3.6.0 ↓3.6.02026-08-12
+3
Daily
5,697
stars
716
forks
102
watchers
2,888
prs
1,109
issues
44
releases

README

CubeFS

















| Community Meeting|
|------------------|
| The CubeFS Project holds bi-weekly community online meeting. To join or watch previous meeting notes and recordings, please see meeting schedule and meeting minutes. |





 Overview

CubeFS ("储宝" in Chinese) is an open-source cloud-native distributed file & object storage system, hosted by the Cloud Native Computing Foundation (CNCF) as a graduated project.

 What can you build with CubeFS

 As an open-source distributed storage, CubeFS can serve as your datacenter filesystem, data lake storage infra, and private or hybrid cloud storage. 
 Moreover, it can be run in public cloud services, providing cache acceleration and file system semantics on top of public cloud storage such as S3.

 In particular, CubeFS enables the separation of storage/compute architecture for databases, search systems, and AI/ML applications.

Some key features of CubeFS include:

- Multiple access protocols such as POSIX, HDFS, S3, and its own REST API
- Highly scalable metadata service with strong consistency  
- Performance optimization of large/small files and sequential/random writes
- Multi-tenancy support with better resource utilization and tenant isolation
- Hybrid cloud I/O acceleration through multi-level caching
- Flexible storage policies, high-performance replication or low-cost erasure coding




 Documents

- English version: https://cubefs.io/docs/master/overview/introduction.html
- Chinese version: https://cubefs.io/zh/docs/master/overview/introduction.html

 Community

- Homepage: cubefs.io
- Mailing list: [email protected]. 
	- Please subscribe on the page https://groups.io/g/cubefs-users/ or send your email to [email protected] to apply.
- Slack: cubefs.slack.com
- WeChat: detail see here
- Twitter: cubefs_storage

 Governance

Governance documentation plays a crucial role in establishing clear guidelines, procedures, and structures within an organization or project

 Contribute
Contributing to CubeFS

There is a clear definition of roles and their promotion paths.
- Becoming a Maintainer
- Becoming a committer
- Becoming a TSC Member


 Partners and Users

There is the list of users and success stories ADOPTERS.md.

 Reference

Haifeng Liu, et al., CFS: A Distributed File System for Large Scale Container Platforms. SIGMOD‘19, June 30-July 5, 2019, Amsterdam, Netherlands. 

For more information, please refer to https://dl.acm.org/citation.cfm?doid=3299869.3314046 and https://arxiv.org/abs/1911.03001


 License

CubeFS is licensed under the Apache License, Version 2.0.
For detail see LICENSE and NOTICE.

 Note

The master branch may be in an unstable or even broken state during development. Please use releases instead of the master branch in order to get a stable set of binaries.

 Star History

Top issues

Discussions

Latest release

Release v3.6.0 - 2026/08/14 v3.6.0 2026-08-12
UPGRAGDE NOTICE
If you are using a CubeFS version earlier than v3.5.0, please refer to the UPGRADE NOTICE in version v3.5.0 for detailed upgrade steps and upgrade to v3.5.0 first.

Upgrade nodes in this order: master → metanode → datanode → flashnode → objectnode → lcnode → cli → client.

_Upgrade lcnode and flashnode when needed._

Before enabling MetaPartition learner-based decommissioning (enableMpDecommissionByLearner), upgrade all MetaNodes first.

Clients should use versions later than 3.2.0. Older versions need to be upgraded promptly; otherwise, there will be a risk of comprom

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON