Question 1

What is IPFS pinning?

Accepted Answer

IPFS pinning keeps your files permanently available on the IPFS network. Without pinning, files may be garbage-collected by IPFS nodes. IPFS.NINJA pins your files to ensure they stay accessible 24/7.

Question 2

What file types can I upload?

Accepted Answer

Any file type. JSON objects are sent natively, while images, PDFs, videos, HTML, and all other formats are base64-encoded. There's no file type restriction.

Question 3

Can I try IPFS.NINJA before paying?

Accepted Answer

Yes. Every new signup starts on a 7-day trial with full Bodhi capacity — 200 files, 10 GB storage, 20 GB monthly bandwidth, 3 API keys, 1 dedicated gateway, 1 IPNS key. No credit card required. On day 8, pick Bodhi at $5/mo, Karma at $19/mo, or Nirvana at $59/mo. If you do not upgrade, your account transitions to a read-only state for 30 days — pinned CIDs continue serving through the gateway during that window and you can re-subscribe at any time to resume uploads.

Question 4

What is a dedicated gateway?

Accepted Answer

Each account gets a private gateway URL (e.g., https://your-slug.gw.ipfs.ninja) to serve your pinned content over HTTPS. You can configure access modes, token authentication, IP whitelisting, and origin restrictions.

Question 5

How do signed upload tokens work?

Accepted Answer

Signed tokens are time-limited credentials you can safely use in client-side code (browsers, mobile apps) without exposing your API key. Create them server-side, pass to the client, upload directly from the browser.

Question 6

Is my data encrypted?

Accepted Answer

Files on IPFS are content-addressed and publicly accessible by CID. If you need privacy, encrypt your data before uploading. The restricted gateway mode ensures only you can access files through your gateway, but the CIDs themselves are public on the IPFS network.

Question 7

Can I pin an existing CID from the network?

Accepted Answer

Yes. Use the POST /pin endpoint with any valid CID to pin content that already exists on IPFS. This is useful for NFT metadata, content mirroring, or archival.

Question 8

How do I cancel or downgrade?

Accepted Answer

You can manage your subscription from the Profile page. Downgrading preserves your files but applies the lower plan's limits. Cancellation transitions your account to a read-only state for 30 days — pinned CIDs continue serving through the gateway during that window and you can re-subscribe at any time to resume uploads. There are no cancellation fees.

Start your 7-day IPFS trial

Create your account with email or social login