Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Pinner Guides

Step-by-step tutorials. Copy, paste, adapt.

What is Pinner?

Pinner is a content pinning service and aggregator for decentralized storage networks. We help you ensure your content remains available on decentralized networks by managing pinning operations across multiple networks.

Currently, Pinner supports IPFS (InterPlanetary File System) with plans to expand to additional storage networks.

What Pinner IS

  • Pinning Service - We store and serve your content identifiers (CIDs) on our infrastructure
  • Privacy-Focused - Your data stays yours; we don't mine or analyze your content for commercial purposes. We scan content we can access (like public IPFS) for abuse and legal compliance. Zero-knowledge services (coming soon) won't be scannable by design.
  • Competitive Pricing - We offer straightforward, fair pricing without hidden subsidies
  • Developer-Friendly - SDKs for JavaScript/TypeScript, CLI tools, and REST APIs

What Pinner IS NOT

  • IPFS Gateway - We don't provide public HTTP gateways for content retrieval
  • Content Delivery Network (CDN) - We don't optimize for low-latency content delivery
  • File Hosting - We don't serve files directly to end users over HTTP (we do serve via the IPFS swarm)

Which guide?

Your situationStart with
New to PinnerWhat is Pinner → First Upload
Using Pinata SDKPinata Migration
CLI-only workflowsCLI Getting Started
Building a web appSDK Getting Started

Before you start

Prerequisites

Getting Your API Token

  1. Sign up at account.pinner.info
  2. Navigate to your account settings
  3. Generate a new API token

Environment Variables

Set the PINNER_API_KEY environment variable:

export PINNER_API_KEY="your-api-token"

Or use PINNER_AUTH_TOKEN for CLI operations:

export PINNER_AUTH_TOKEN="your-api-token"

What's next?

After completingReady for
First UploadSDK deep dives, CLI reference
Pinata MigrationProduction switchover

What is Pinner? →  Upload your first file →  Migrate from Pinata →