Back

Blog details

Understanding IPFS Pinning Services

AIOZ Network
4 min readFebruary 08, 2024
aioz-depinaioz-pin

Most web pages don't survive long. IPFS solves the storage and addressing half of that problem, distributing files across a peer-to-peer network instead of one server, but it doesn't solve persistence on its own. Nodes periodically run garbage collection to free up space, and content nobody's actively keeping around can quietly get dropped. Pinning is the mechanism that prevents that, and a pinning service is what makes pinning practical without running your own IPFS infrastructure. Here's exactly how it works.

TL;DR:

  • IPFS nodes run garbage collection to free up storage, which can delete content nobody has explicitly marked to keep
  • Pinning marks specific data to survive that garbage collection, guaranteeing it stays available on at least one node
  • A pinning service manages that pinning process on your behalf, so you don't need to run and maintain your own IPFS node
  • The IPFS Pinning Service API is a standardized spec multiple providers implement, which means switching providers doesn't require rewriting your integration
  • AIOZ Pin implements that standard on top of a DePIN-distributed node network, with pay-as-you-go billing rather than a fixed subscription tier

Why Data Needs to Be Pinned At All

IPFS nodes have limited storage capacity, and to manage that, they periodically run garbage collection, a process that clears out data to free up space. Content that nobody has explicitly told the node to keep is fair game to be removed during that process, including data other people might still be trying to reach. That's the specific gap pinning closes: pinning marks data to be retained through garbage collection instead of cleared, which is what actually makes "stored on IPFS" mean "stays reachable on IPFS."

What a Pinning Service Actually Does

A pinning service is a third-party provider that manages the pinning process for you. Rather than running your own IPFS node, keeping it online, and monitoring its storage, you upload content to the service and it handles pinning that content across infrastructure it maintains. In practice, that removes several real burdens:

  • No node to run. You don't need to configure, host, or keep an IPFS node online yourself.
  • Reliability that doesn't depend on your own uptime. A local hardware failure, a power outage, or a home connection going down doesn't take your pinned content offline with it.
  • Scale without new hardware. Storage needs grow by uploading more, not by provisioning more infrastructure.
  • Geographic distribution. Content pinned across multiple locations reduces latency for users and reduces the blast radius of any single regional outage.

The IPFS Pinning Service API: Why Portability Matters

One detail worth knowing before picking a provider: the IPFS Pinning Service API is a standardized specification, not something each vendor invents independently. Multiple providers implement the same spec, which means a pinning integration built against the standard API can, in principle, switch providers without a full rewrite. That portability is a genuine, underused advantage of sticking to standards-based tooling rather than a provider's proprietary API.

How AIOZ Pin Implements This

AIOZ Pin is a pinning service built on the AIOZ DePIN, a distributed network of independent nodes rather than one centralized provider's infrastructure. Concretely, that means:

  • Pinning Service API compliance, so integrations aren't locked to a single vendor's proprietary interface
  • Pay-as-you-go billing funded through an AIOZ token wallet, rather than a fixed monthly subscription tier
  • Premium gateways for production-grade retrieval that isn't subject to the rate limits of the shared public gateway
  • A Node.js SDK and CLI (pinFilesToIPFS(), pinFolderToIPFS(), pinByHash(), plus a standalone CLI tool) for pinning programmatically rather than through a dashboard alone

What to Actually Check Before Picking a Provider

Not every claim of "reliable pinning" means the same thing in practice. A few questions worth asking before committing to a provider:

  • Does it implement the standard Pinning Service API, or a proprietary interface that locks your integration to one vendor?
  • Is pricing actually published, with real numbers, or does it require a sales conversation to find out what something costs at scale?
  • What happens when a payment lapses or a balance runs out? Some providers unpin immediately; others give a grace period. This is worth knowing before it happens, not after.
  • Does it support the specific workflow you need, NFT metadata pinning, folder pinning, hash-based pinning of content someone else uploaded, rather than just single-file uploads through a dashboard?

None of these are exotic requirements, but they're also not always obvious from a provider's marketing page, and they're exactly the kind of thing worth checking against actual documentation rather than assuming.

Frequently Asked Questions

Why does IPFS content ever disappear if it's decentralized? Because a node's storage is finite. Garbage collection periodically clears content nobody has explicitly pinned, and if no other node is hosting a copy, that content becomes unreachable.

What does "pinning" actually do? It marks specific data to be retained through a node's garbage collection process, guaranteeing that node keeps a copy instead of clearing it to free up space.

Do I need to run my own IPFS node to use a pinning service? No. That's the specific problem a pinning service solves, it manages the pinning and hosting infrastructure so you don't have to run or maintain a node yourself.

What is the IPFS Pinning Service API? A standardized specification for pinning-service integrations. Because multiple providers implement the same API, switching providers doesn't necessarily require rewriting your integration from scratch.

How is AIOZ Pin's billing different from a typical cloud storage subscription? It's pay-as-you-go, funded by depositing AIOZ tokens into an account wallet, rather than a fixed monthly tier. Usage is deducted from that balance daily as storage and bandwidth actually accrue.

Can pinned content still be lost? The garbage-collection risk pinning solves is real, but no storage guarantee is absolute. Reviewing a provider's actual replication and persistence mechanics, not just the marketing claim, is worth doing before treating any single copy as permanent.

References

We only send updates when meaningful changes ship, and you can unsubscribe anytime

Related Content

blog thumbnail

Content Moderation on IPFS: What Actually Happens

Pinning services can remove their own copy of a file. They cannot remove it from IPFS. Here is exactly what a takedown does and does not accomplish.

5 min readSeptember 12, 2026
blog thumbnail

IPFS Transports: TCP vs. QUIC Explained

libp2p connections can run over more than one transport. Here is exactly what changes with QUIC instead of TCP, and why IPFS dials both at once.

5 min readSeptember 11, 2026
blog thumbnail

GossipSub: How IPFS's PubSub Layer Actually Works

The DHT answers who has a CID. GossipSub answers a different question: how do peers push real-time updates to everyone listening, without a lookup at all.

5 min readSeptember 10, 2026
blog thumbnail

Helia: IPFS's Modern JavaScript Implementation

js-ipfs is deprecated. Helia is what replaced it: a modular, TypeScript-first IPFS implementation built for the browser and Node.js. Here is how it fits.

5 min readSeptember 09, 2026
blog thumbnail

IPLD Selectors: Fetching Part of a DAG, Not All of It

Not every retrieval needs the whole DAG. IPLD Selectors describe exactly which nodes to traverse and match, so a client can fetch a slice, not everything.

5 min readSeptember 08, 2026
blog thumbnail

ipfs:// in the Browser: How It Actually Works

Almost no browser understands ipfs:// links natively. Here is exactly why, what IPFS Companion actually does about it, and why gateway URLs took over instead.

5 min readSeptember 07, 2026