InterPlanetary File System (IPFS)

IPFS, short for InterPlanetary File System, is a set of open protocols for sharing and retrieving files across a peer-to-peer network using identifiers based on their content.

Zelf Core Team

What Is IPFS?

IPFS lets computers exchange files without relying on a single hosting server. Participating computers, called nodes, can store and share content with other nodes.

On the traditional web, a link usually points to a location: a particular file on a particular server. IPFS uses content addressing, which identifies the data you want rather than specifying the server that must deliver it.

This means multiple nodes can provide the same content under the same identifier. Files can remain accessible through other participating nodes when one source becomes unavailable, provided those nodes retain and serve the data.IPFS Documentation: What Is IPFS?

IPFS can support websites, documents, media, NFT metadata, and encrypted application backups. It can work alongside blockchains, but IPFS itself is not a blockchain, and adding a file does not create an on-chain transaction.

How Does IPFS Work?

IPFS combines content identifiers with peer-to-peer networking to help nodes locate, retrieve, and verify data.

1. Content Receives an Identifier

When a file is added to IPFS, it is represented as data blocks linked through cryptographic hashes. A Content Identifier, or CID, identifies the resulting content structure.

Changing the content changes its CID. Adding identical content with the same settings produces the same CID, allowing different nodes to reference the same data consistently.IPFS Documentation: Content Identifiers

2. Nodes Locate and Retrieve the Data

When you request a CID, your IPFS software looks for nodes that can provide the relevant blocks. It retrieves those blocks and verifies them against their identifiers.

You can also access IPFS content through an HTTP gateway, which lets a regular web browser retrieve files without running an IPFS node itself.

For example, an application might reference a document using an address beginning with ipfs://. That address identifies the content; a compatible application or gateway handles retrieval.

3. Pinning Helps Keep Files Available

IPFS does not automatically store every file on every node or guarantee permanent availability.

Pinning tells a node to retain particular content rather than remove it during routine cleanup. You can pin files on your own node or use a remote pinning service.

For reliable access, at least one reachable node must continue retaining and serving the required data. Keeping copies across multiple maintained nodes can improve resilience.IPFS Documentation: Pinning Files

Why Does IPFS Matter?

IPFS gives applications another way to distribute information, verify its integrity, and reduce dependence on a single hosting location.

Its main benefits include:

Verifiable content: Content identifiers allow IPFS software to check that retrieved data matches what was requested.

Flexible distribution: Multiple nodes can provide the same content, giving applications additional sources for retrieval.

Clear version references: A CID identifies a specific version of content. An updated file receives a different identifier.

Support for decentralized applications: Applications can reference files and metadata stored outside a blockchain, avoiding the need to place large files directly on-chain.

These benefits depend on how the application manages storage, retrieval, and security. A CID verifies the content it identifies; it does not establish whether that content is accurate, trustworthy, or safe.

Privacy Requires Encryption

IPFS does not automatically make stored files private. On the public network, someone who knows a file’s CID may be able to retrieve it if a node makes it available. Network metadata can also reveal information about participating nodes and the content they provide.

Sensitive information should therefore be encrypted before it is added to IPFS. The application must separately manage who can decrypt it and how encryption keys are protected and recovered.IPFS Documentation: Privacy and Encryption

For a self-custody application, IPFS can serve as a distribution layer for encrypted backups. The encryption protects their contents, while maintained copies support availability. Recovering a readable backup still requires access to the appropriate decryption keys.

Related terms

← Back to glossary