developers.cloudflare.com Open in urlscan Pro
2606:4700::6810:6bd  Public Scan

Form analysis
4 forms found in the DOM

<form class="astro-x6kpz2mu">
  <fieldset class="astro-x6kpz2mu">
    <div class="astro-x6kpz2mu"> <input type="radio" id="accurate" value="accurate" name="reason" class="astro-x6kpz2mu"> <label for="accurate" class="astro-x6kpz2mu">Accurate</label> </div>
    <div class="astro-x6kpz2mu"> <input type="radio" id="easy-to-understand" value="easy-to-understand" name="reason" class="astro-x6kpz2mu"> <label for="easy-to-understand" class="astro-x6kpz2mu">Easy to understand</label> </div>
    <div class="astro-x6kpz2mu"> <input type="radio" id="solved-my-problem" value="solved-my-problem" name="reason" class="astro-x6kpz2mu"> <label for="solved-my-problem" class="astro-x6kpz2mu">Solved my problem</label> </div>
    <div class="astro-x6kpz2mu"> <input type="radio" id="helped-me-decide-to-use-the-product" value="solved-my-problem" name="reason" class="astro-x6kpz2mu"> <label for="helped-me-decide-to-use-the-product" class="astro-x6kpz2mu">Helped me decide to
        use the product</label> </div>
    <div class="astro-x6kpz2mu"> <input type="radio" id="other" value="other" name="reason" class="astro-x6kpz2mu"> <label for="other" class="astro-x6kpz2mu">Other</label> <input type="text" placeholder="Tell us more about your experience." id="info"
        name="info" class="astro-x6kpz2mu"> </div> <input type="submit" value="Submit" class="astro-x6kpz2mu">
  </fieldset>
</form>

<form class="astro-x6kpz2mu">
  <fieldset class="astro-x6kpz2mu">
    <div class="astro-x6kpz2mu"> <input type="radio" id="hard-to-understand" value="hard-to-understand" name="reason" class="astro-x6kpz2mu"> <label for="hard-to-understand" class="astro-x6kpz2mu">Hard to understand</label> </div>
    <div class="astro-x6kpz2mu"> <input type="radio" id="incorrect-information" value="incorrect-information" name="reason" class="astro-x6kpz2mu"> <label for="incorrect-information" class="astro-x6kpz2mu">Incorrect information</label> </div>
    <div class="astro-x6kpz2mu"> <input type="radio" id="missing-the-information" value="missing-the-information" name="reason" class="astro-x6kpz2mu"> <label for="missing-the-information" class="astro-x6kpz2mu">Missing the information</label> </div>
    <div class="astro-x6kpz2mu"> <input type="radio" id="other" value="other" name="reason" class="astro-x6kpz2mu"> <label for="other" class="astro-x6kpz2mu">Other</label> <input type="text" placeholder="Tell us more about your experience." id="info"
        name="info" class="astro-x6kpz2mu"> </div> <input type="submit" value="Submit" class="astro-x6kpz2mu">
  </fieldset>
</form>

<form class="astro-x6kpz2mu">
  <fieldset class="astro-x6kpz2mu">
    <div class="astro-x6kpz2mu"> <input type="radio" id="accurate" value="accurate" name="reason" class="astro-x6kpz2mu"> <label for="accurate" class="astro-x6kpz2mu">Accurate</label> </div>
    <div class="astro-x6kpz2mu"> <input type="radio" id="easy-to-understand" value="easy-to-understand" name="reason" class="astro-x6kpz2mu"> <label for="easy-to-understand" class="astro-x6kpz2mu">Easy to understand</label> </div>
    <div class="astro-x6kpz2mu"> <input type="radio" id="solved-my-problem" value="solved-my-problem" name="reason" class="astro-x6kpz2mu"> <label for="solved-my-problem" class="astro-x6kpz2mu">Solved my problem</label> </div>
    <div class="astro-x6kpz2mu"> <input type="radio" id="helped-me-decide-to-use-the-product" value="solved-my-problem" name="reason" class="astro-x6kpz2mu"> <label for="helped-me-decide-to-use-the-product" class="astro-x6kpz2mu">Helped me decide to
        use the product</label> </div>
    <div class="astro-x6kpz2mu"> <input type="radio" id="other" value="other" name="reason" class="astro-x6kpz2mu"> <label for="other" class="astro-x6kpz2mu">Other</label> <input type="text" placeholder="Tell us more about your experience." id="info"
        name="info" class="astro-x6kpz2mu"> </div> <input type="submit" value="Submit" class="astro-x6kpz2mu">
  </fieldset>
</form>

<form class="astro-x6kpz2mu">
  <fieldset class="astro-x6kpz2mu">
    <div class="astro-x6kpz2mu"> <input type="radio" id="hard-to-understand" value="hard-to-understand" name="reason" class="astro-x6kpz2mu"> <label for="hard-to-understand" class="astro-x6kpz2mu">Hard to understand</label> </div>
    <div class="astro-x6kpz2mu"> <input type="radio" id="incorrect-information" value="incorrect-information" name="reason" class="astro-x6kpz2mu"> <label for="incorrect-information" class="astro-x6kpz2mu">Incorrect information</label> </div>
    <div class="astro-x6kpz2mu"> <input type="radio" id="missing-the-information" value="missing-the-information" name="reason" class="astro-x6kpz2mu"> <label for="missing-the-information" class="astro-x6kpz2mu">Missing the information</label> </div>
    <div class="astro-x6kpz2mu"> <input type="radio" id="other" value="other" name="reason" class="astro-x6kpz2mu"> <label for="other" class="astro-x6kpz2mu">Other</label> <input type="text" placeholder="Tell us more about your experience." id="info"
        name="info" class="astro-x6kpz2mu"> </div> <input type="submit" value="Submit" class="astro-x6kpz2mu">
  </fieldset>
</form>

Text Content

Skip to content
Cloudflare Docs
SearchK
Products Learning Status Support Log in
GitHub X YouTube
Select theme DarkLightAuto
Web3
 * Overview
 * About
 * Get started
 * How to
    * Overview
    * Manage gateways
    * Subscribe to gateways
    * Use Ethereum gateway
    * Use IPFS gateway
    * Customize Cloudflare settings
    * Restrict gateway access

 * IPFS Gateway
    * Overview
    * Concepts
       * Overview
       * Interplanetary File System (IPFS)
       * DNSLink gateways
       * Universal Path gateway
   
    * Reference
       * Overview
       * Peering
       * Using IPFS with your website
       * Automated deployments
   
    * Troubleshooting

 * Ethereum Gateway
    * Overview
    * Concepts
       * Overview
       * Ethereum network
       * Node types
   
    * Reference
       * Overview
       * Supported API methods
       * Supported networks
       * Rinkeby deprecation
       * Kill Switches

 * Reference
    * Overview
    * Gateway DNS records
    * Gateway status
    * Legacy gateway migration
    * Limits

 * API reference ↗ API

Products Learning Status Support Log in
GitHub X YouTube
Select theme DarkLightAuto
On this page
Overview
 * Overview
 * Create a gateway
 * Edit a gateway
 * Refresh a gateway
 * Update blocklist
 * Delete a gateway


ON THIS PAGE

 * Overview
 * Create a gateway
 * Edit a gateway
 * Refresh a gateway
 * Update blocklist
 * Delete a gateway



WAS THIS HELPFUL?

Yes No


WHAT DID YOU LIKE?

Accurate
Easy to understand
Solved my problem
Helped me decide to use the product
Other


WHAT WENT WRONG?

Hard to understand
Incorrect information
Missing the information
Other


THANK YOU FOR HELPING IMPROVE CLOUDFLARE'S DOCUMENTATION!

 1. Products
 2. …
 3. Web3
 4. How to
 5. Manage gateways


MANAGE GATEWAYS

A Cloudflare Web3 gateway provides HTTP-accessible interfaces to various Web3
networks. You can interact with a gateway in several ways.


CREATE A GATEWAY

 * Dashboard
 * API

To create a gateway using the dashboard:

 1. Log in to the Cloudflare dashboard ↗.
 2. Select your account and website.
 3. Go to Web3.
 4. Click Create Web3 Gateway.
 5. Enter the following information:

 * Hostname: Enter a hostname to use as your gateway, which has to be a
   subdomain of the current Cloudflare zone.
 * Gateway Description: Enter a description to help distinguish between
   different gateways.
 * Gateway Type: Select a gateway target of IPFS DNSLink, IPFS Universal Path,
   or Ethereum.
 * DNSLink: Only applicable to IPFS gateways, more details at DNSLink.

 6. Click Deploy.

To create a gateway using the API, send a POST request that includes the
following parameters:

 * name: The hostname that will point to the target gateway via a CNAME record.
 * target: The gateway target for the hostname (ethereum, ipfs,
   ipfs_universal_path).

If you need help with API authentication, refer to Cloudflare API documentation.

Request
curl "https://api.cloudflare.com/client/v4/zones/{zone_id}/web3/hostnames" \
--header "X-Auth-Email: <EMAIL>" \
--header "X-Auth-Key: <API_KEY>" \
--header "Content-Type: application/json" \
--data '{
  "name": "gateway.example.com",
  "description": "This is my IPFS gateway.",
  "target": "ipfs",
  "dnslink": "/ipns/onboarding.ipfs.cloudflare.com"
}'



The response contains the complete definition of the new gateway.

Response
{
  "success": true,
  "errors": [],
  "messages": [],
  "result": {
    "id": "<WEB3_GATEWAY_ID>",
    "name": "gateway.example.com",
    "description": "This is my IPFS gateway.",
    "status": "active",
    "target": "ipfs",
    "dnslink": "/ipns/onboarding.ipfs.cloudflare.com",
    "created_on": "<CREATED_ON_DATE>",
    "modified_on": "<MODIFIED_ON_DATE>"
  }
}



When you create a gateway, Cloudflare automatically:

 * Creates and adds records to your Cloudflare DNS so your gateway can receive
   and route traffic appropriately.
 * Proxies traffic to that hostname.
 * Issues an SSL/TLS certificate to cover the specified hostname.

--------------------------------------------------------------------------------


EDIT A GATEWAY

Once you have created a gateway, you can only edit the Gateway Description and —
if it is an IPFS gateway — also edit the value for the DNSLink field.

If you need to edit other fields, delete the gateway and create a new one.

 * Dashboard
 * API

To edit a gateway using the dashboard:

 1. Log in to the Cloudflare dashboard ↗.
 2. Select your account and website.
 3. Go to Web3.
 4. On a specific gateway, click Edit.
 5. Update the Gateway Description and — if editing an IPFS gateway — the value
    for the DNSLink.
 6. Click Reapply.

To edit specific settings for a gateway, use a PATCH request.

--------------------------------------------------------------------------------


REFRESH A GATEWAY

When your gateway is stuck in an Error status, you should try refreshing the
gateway, which attempts to re-create the associated DNS records for the
hostname.

 * Dashboard
 * API

To refresh a gateway using the dashboard:

 1. Log in to the Cloudflare dashboard ↗.
 2. Select your account and website.
 3. Go to Web3.
 4. On a gateway, click the dropdown then Refresh.

To refresh a gateway using the API, send a PATCH request with an empty request
body.

--------------------------------------------------------------------------------


UPDATE BLOCKLIST

When you set up a IPFS Universal Path gateway, you may want to add items to the
gateway blocklist, which allows you to block access to specific content.

You have the ability to block access to one or more:

 * CIDs (QmPZ9gcCEpqKTo6aq61g2nXGUhM4iCL3ewB6LDXZCtioEB)
 * IPFS content paths
   (/ipfs/QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG/readme)
 * IPNS content paths (/ipns/example.com)

 * Dashboard
 * API

To add an item to the blocklist using the dashboard:

 1. Log in to the Cloudflare dashboard ↗.

 2. Select your account and website.

 3. Go to Web3.

 4. On a specific gateway, click the dropdown then Blocklist.

 5. Click Add entry.

 6. Enter the following information:
    
    * Blocklist entry type: Choose CID or Content path.
    * Blocklist entry content: Add a CID or content path to block, meaning
      either a valid CIDv0 or CIDv1 string (CID) or the entry should start with
      /ipfs/ or /ipns/ (content path).
    * Blocklist entry description: Add a description to help you identify the
      blocklist entry.

 7. Click Add.

To add a blocklist item using the API, send a POST request.

--------------------------------------------------------------------------------


DELETE A GATEWAY

When you delete a gateway, Cloudflare will automatically remove all associated
hostname DNS records. This action will impact your traffic and cannot be undone.

 * Dashboard
 * API

To delete a gateway using the dashboard:

 1. Log in to the Cloudflare dashboard ↗.
 2. Select your account and website.
 3. Go to Web3.
 4. On a specific gateway, click the dropdown then Remove.
 5. Click Delete hostname.

To delete a gateway using the API, send a DELETE request.


WAS THIS HELPFUL?

Yes No


WHAT DID YOU LIKE?

Accurate
Easy to understand
Solved my problem
Helped me decide to use the product
Other


WHAT WENT WRONG?

Hard to understand
Incorrect information
Missing the information
Other


THANK YOU FOR HELPING IMPROVE CLOUDFLARE'S DOCUMENTATION!

Edit page

Cloudflare DashboardDiscordCommunityLearning CenterSupport Portal
Your Privacy Choices