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 situation | Start with |
|---|---|
| New to Pinner | What is Pinner → First Upload |
| Using Pinata SDK | Pinata Migration |
| CLI-only workflows | CLI Getting Started |
| Building a web app | SDK Getting Started |
Before you start
Prerequisites
- API key from account.pinner.info
- Node.js 20+ or browser environment
- ~5 minutes
Getting Your API Token
- Sign up at account.pinner.info
- Navigate to your account settings
- 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 completing | Ready for |
|---|---|
| First Upload | SDK deep dives, CLI reference |
| Pinata Migration | Production switchover |
What is Pinner? → Upload your first file → Migrate from Pinata →