# XTXMarkets/ternfs

An exabyte-scale, multi-region distributed file system

Repository: https://github.com/XTXMarkets/ternfs
Canonical: https://ross.abutalabs.com/products/ternfs
Language: C++
License Family: other
Last push: 2026-08-21T11:04:31+00:00

## Health v2 (maintenance only)
Score: 62/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 98, release rhythm 37, longevity 26
- inputs: {"age_days": 365, "days_push": 12, "days_rel": 205, "gap_med": null, "n_releases_24m": 1}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1339, forks 96 (observed 2026-08-28T04:04:25.896094+00:00)

## What it is
TernFS is an exabyte-scale, multi-region distributed file system written in C++, designed for storing large immutable files on commodity hardware and Ethernet networking. It is used in production at XTX Markets for machine learning workloads and supports trillions of files, replication across data centers, and recovery from node failures or bitrot.

## Use cases
- store petabyte or exabyte-scale ML training datasets
- build a multi-region replicated file system across data centers
- serve large immutable files to thousands of compute clients
- replace HDFS or similar HPC storage with commodity hardware
- recover accidentally deleted files with a configurable deletion policy

## When to choose
- you need to store and read very large mostly-immutable files at extreme scale
- you want multi-datacenter replication to survive a full datacenter failure
- you prefer commodity hardware and Ethernet over specialized storage appliances
- you need strong durability guarantees against bitrot and node failure

## When to avoid
- your workload involves frequently modified small files or heavy directory churn
- you need a mature 1.0 filesystem with long-term API stability
- you need POSIX compliance for arbitrary application workloads
- you want a plug-and-play solution rather than operating your own distributed storage cluster

## Facets
- artifact type: service
- maturity: active
- function: file-system, microservices
- domain: microservices, machine-learning, big-data
- platform: cpp, self-hosted
- tags: distributed-file-system, exabyte-scale, multi-region, immutable-files, erasure-coding, posix, commodity-hardware, storage, infrastructure, linux, docker

## Member repositories
- XTXMarkets/ternfs (main) score 62

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:25.896094+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-30T04:43:53.521817+00:00, confidence not recorded.
  - readme: https://github.com/XTXMarkets/ternfs (fetched 2026-08-28T04:04:25.896094+00:00, sha 35731ff7643e)
- Data as of 2026-08-30T08:39:29.467469+00:00.