IPFS Cluster Overview

IPFS Cluster is a software to orchestrate IPFS daemons running on different hosts.

A typical IPFS Cluster

An IPFS Cluster is formed by a number of Peers, each of them associated to one IPFS daemon. The peers share a pinset (also known as shared state) which lists the CIDs which are cluster-pinned and their properties (allocations, replication factor etc.).

Cluster peers communicate using libp2p (cluster swarm), similarly to IPFS, but separately from it. Thus, every cluster peer needs its own Private Key (different from the one used by the IPFS daemon) and has its own Peer ID. All peers share an additional secret key which ensures they can only communicate with known parties.

IPFS Cluster is used by Protocol Labs to maintain and replicate a large pinset, via integrations like the IRC IPFS Pinbot.

Current features

The latest stable release of IPFS Cluster includes the following features:

Current limitations

These are the currently observed main problems and things lacking in IPFS Cluster (from what people expect). Be sure to check our Roadmap to see how and when we are planning to address them:

Next steps: Download