All Collections
How To Set Up A Dedicated IPFS Gateway
How To Set Up A Dedicated IPFS Gateway
Steve Simkins avatar
Written by Steve Simkins
Updated over a week ago

For those who need greater speed or increased rate limits when retrieving content, Pinata lets users on our picnic plan create dedicated gateways.

What are the benefits of a dedicated gateway?

  • Unmatched speed through our over 200 edge caching locations around the world

  • No rate limits for requesting content

Getting Started

On the Gateway Page, simply click Create Gateway:

You'll be prompted to create your gateway through an easy-to-use wizard. Provide a name for your gateway then choose whether your gateway is open or restricted.

Open vs. Restricted

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.

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. This is great for wide accessibility, but can lead to higher usage costs. Restricted gateways mean that you're only charged for delivering your content.

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.

How Do I Use 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.

Adding a Custom Domain

Pinata also allows you to create a custom domain for your dedicated gateway. Simple 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.

Did this answer your question?