Gateways

The Gateways page is where you can create and manage Dedicated Gateways from your Pinata account. For more info on how to use them check out this page.

When you sign up for a Pinata plan you will receive an automatically generated dedicated gateway with a random subdomain, and it will be listed on the page with a bandwidth meter.

If you don't see a gateway, you can make one by clicking "Create Gateway" which will let you choose an available subdomain.

Bandwidth

At the top of the page you can see how much of your bandwidth allowance you have used for the month. This refreshes after every billing cycle. You can also view this info on the Billing and Usage page.

Access

By default all Dedicated Gateways are restricted, meaning they will only allow through CIDs that are pinned to your account. This prevents abuse from people who would try to use the gateway for their own purposes and drive up your bandwidth and requests. Dedicated Gateways can be opened by using Gateway Access Controls, which allow CIDs outside the account to go through but only when an access control is met. If you have a Gateway Access Control on a gateway, it will be listed as "Open" on this page.

Custom Domains

You can use your own custom domain so the gateway could be used to match your branding, e.g. https://coolwebsite.com/ipfs/<CID>. To do this, click on the options button on the right side of a gateway and click "add custom domain."

This will prompt you to type in the domain you want to use. After doing so and refreshing the page, click on the options button again to see the domain info.

This will give you a DNS record you will need to enter in through your domain provider (e.g. Namecheap, GoDaddy). It typically follows the format of:

Setting Gateway Root

A unique feature on Dedicated Gateways is the ability to set a file as the gateway root. It's a simple redirect of a gateway root url to a specific CID you have designated. For instance, if you visit https://pinata-media.mypinata.cloud you would be redirected to https://pinata-media.mypinata.cloud/ipfs/QmVLwvmGehsrNEvhcCnnsw5RQNseohgEkFNN1848zNzdng. This is create for websites hosted on Pinata or smaller projects (like this cool photo zine).

To set a file as the gateway root, simply go to the Files Page and click on "more" for the desired file, then click "Set as gateway root."

Removing a Gateway

If for any reason you want to delete a gateway, simply click on the options button and click "Remove Gateway."