Pinata Docs

Dedicated Gateways

A comprehensive guide to dedicated gateways.
Pinata's Dedicated Gateways are for users need faster speed or increased rate limits when retrieving content.
Dedicated Gateways are private IPFS gateways which allow you to access pinned content with faster speeds and increased rate limits. You can consider them the red carpet experiencing to accessing and serving content.

What are the Benefits of a Dedicated Gateway?

  • Personalization: Integrate custom domains and keep your branding consistent
  • Limitless: No rate limits for requesting content
  • Security: Control who can access your content
  • Reliability & High-Performance: Enjoy unmatched speed through our 200+ edge-caching locations around the world

Limited Dedicated Gateways

Users on our free plan have access to a limited dedicated gateway. In this version, users get a taste of the speed of dedicated gateways with the ability to serve individual files such as images, videos and audio. However, files containing HTML and scripts will not be served*.
*Upload functionality is not affected.
Free plan users wanting more out of their limited dedicated gateway can simply upgrade to any of our flexible premium plans (starting at just $20/month)

Getting Started

  • First things first, sign up for a Pinata account
  • Pinata creates dedicated gateways for all new users by default. Navigate to your 'Gateways' tab and you will see your dedicated gateway waiting for you.
If you'd like to start anew and create a new gateway, or if your plan allows the creation of more than 1, you can follow our step-by-step guide below:

How To Create Your Dedicated Gateway

  1. 1.
    On your dashboard, navigate to the 'Gateways' tab. Click on 'Create Gateway'. This will prompt our easy-to-use gateway wizard.
Step 1: Navigate to "Gateways'
  1. 2.
    Choose a unique name for your Gateway. Gateways are restricted by default.
  2. 3.
    Et voila!
    You should now be able to see your new gateway on your dashboard.
Optional: Add your own custom domain or additional security measures.

How Do I Use My Gateway?

How do I serve IPFS content through my gateway?

To view content through your gateway, grab the CID of the file you'd like to view and add it to your gateway URL like this:
https://<Your Gateway Subdomain><Your CID>
Simple as that!

How do I convert other gateway URLs to use my gateway?

In many cases, projects will directly put an entire gateway URL on-chain (such as when minting NFTs).
If you find yourself reading from a location that may provide a gateway URL, Pinata created the ipfs-gateway-tools toolkit to help you out.
This toolkit can easily convert any standard IPFS gateway URL, as well as URIs with the ipfs://<CID> format to a URL that utilizes your gateway.

How can I add a custom domain?

Pinata also allows you to create a custom domain for your dedicated gateway. Simply click the menu button on the right side of your gateway row in the table on the Gateways page, then click Add Custom Domain. You'll need to own the domain you want to use. When you enter your domain, you will be prompted to enter DNS information through your registrar.

Frequently Asked Questions

What is the difference between Open vs. Restricted gateways?

What's the difference between an open gateway and a restricted gateway? In both cases, the content served by the gateway will be available to anyone with the link. However, the restricted gateway will only serve content that is pinned on your account.
Dedicated gateways will be restricted by default.
An open gateway will (assuming it can find the content on the IPFS network) serve up any content even if it's not pinned to your account.
Open gateways are great for wide accessibility but without proper Gateway Access Controls to safeguard your gateway, are susceptible to abuse (and can result in usage costs to go through the roof

How do I change my gateway from restricted to open?

To change a gateway from restricted to open, you would need to use the Gateway Access Controls, by adding either an Access Token, Host Origin, or IP Address. When you add one of these access controls, the gateway will be able to fetch content outside your account as the restriction requirement is met.

What is Bandwidth?

Bandwidth is the data that represents the item you or your users are viewing through your dedicated gateway. Each image, video, audio, and any other type of file that is displayed through the gateway or downloaded through the gateway is made of up data. That data is sent from an IPFS node to your computer. The size of this data is bandwidth.
You can track your bandwidth for any gateway you have set up by going to your Gateways page and clicking on the subdomain link for your gateway.

We want your feedback!

Have a suggestion? Have a complaint? Confused about something in the documentation? Just want to say hi?
We want to make Pinata the best product available. That involves listening to our users and addressing their needs.
Send us an email at [email protected] and we'll see how we can help.