Get started (13)

Last updated May 1, 2026 Use this tutorial to set up a Cloudflare Web3 gateway, which gives your application HTTP access to the IPFS or Ethereum network without running your own node.

Before you begin

Before you start, make sure you have set up an account and added your website to Cloudflare.

Step 1 - Subscribe to a gateway

Web3 gateways are a paid add-on. To get access, subscribe to a gateway.

Step 2 - Create a gateway

After purchasing a gateway subscription, create a gateway.

<details>

<summary>

Create via dashboard

</summary>

To create a gateway using the dashboard:

  1. In the Cloudflare dashboard, go to the Web3 page.<a href="https://dash.cloudflare.com/?to=/:account/:zone/web3">Go to Web3 ↗</a>
  2. Click Create Gateway.

  3. Enter the following information:

  4. Hostname: Enter a hostname to use as your gateway, which has to be a subdomain of the current Cloudflare zone.

  5. Gateway Description: Enter a description to help distinguish between different gateways.
  6. Gateway Type: Select a gateway target of <a href="https://developers.cloudflare.com/web3/ipfs-gateway/concepts/dnslink/">IPFS DNSLink</a>, <a href="https://developers.cloudflare.com/web3/ipfs-gateway/concepts/universal-gateway/">IPFS Universal Path</a>, or <a href="https://developers.cloudflare.com/web3/ethereum-gateway/">Ethereum</a>.

  7. DNSLink: Only applicable to IPFS gateways, more details at <a href="https://developers.cloudflare.com/web3/ipfs-gateway/concepts/dnslink/#how-is-it-used-with-cloudflare">DNSLink</a>.

  8. Click Deploy.

</details>

<details>

<summary>

Create via API

</summary>

To create a gateway using the API, send a <a href="https://developers.cloudflare.com/api/resources/web3/subresources/hostnames/methods/create/"><code>POST</code></a> request that includes the following parameters:

  • <code>name</code>: The hostname that will point to the target gateway via a <code>CNAME</code> record.
  • <code>target</code>: The gateway target for the hostname (<code>ethereum</code>, <code>ipfs</code>, <code>ipfs_universal_path</code>).

If you need help with API authentication, refer to <a href="https://developers.cloudflare.com/fundamentals/api/">Cloudflare API documentation</a>.

Requestbash

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.

Responsejson

{
  "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>"
  }
}

</details>

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.

Step 3 - Customize Cloudflare settings

Once your gateway becomes active, you can customize the Cloudflare settings associated with your hostname.

Since your traffic is automatically proxied through Cloudflare, you customize your website settings to take advantage of various security, performance, and reliability benefits.

Step 4 - Restrict gateway access (optional)

If you are using your gateway for backend services, you may want to use Cloudflare Zero Trust to restrict gateway access.

Step 5 - Set up usage notifications

Since this is a service with usage-based billing, Cloudflare recommends that you set up usage-based billing notifications to avoid unexpected bills.

To set up those notifications:

  1. In the Cloudflare dashboard, go to the Notifications page. Go to Notifications ↗
  2. On Alert Type of Usage Based Billing, click Select.
  3. Fill out the following information:
  4. Name
  5. Product
  6. Notification limit (exact metric will vary based on product)
  7. Notification email

Note

All plans can send alerts through webhooks. Business and higher plans can also use PagerDuty. 4. Select Save.

Step 6 - Use the gateway

Once you have created a gateway and updated your Cloudflare settings, you can start using your IPFS or Ethereum.

Was this helpful?

YesNo

On this page

Get started (13) - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/web3/get-started/#page","headline":"Get started","description":"Set up a Cloudflare Web3 gateway for Ethereum or IPFS.","url":"https://developers.cloudflare.com/web3/get-started/","inLanguage":"en","image":"https://developers.cloudflare.com/web3/get-started/og.png?v=97d8eac534befe88","dateModified":"2026-05-01","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: Apply Cloudflare security and performance settings to your Web3 gateway. title: Customize Cloudflare settings image: https://developers.cloudflare.com/web3/how-to/customize-cloudflare-settings/og.png?v=81c68a90f866871b

Skip to content

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/web3/llms.txt
Use this file to discover all available pages before exploring further.