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
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.
Via the dashboard
To create a gateway using the dashboard:
- Log in to the Cloudflare dashboard.
- Select your account and website.
- Go to Web3.
- Click Create Web3 Gateway.
- 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 or Ethereum.
- DNSLink: Only applicable to IPFS gateways, more details at DNSLink.
- Click Deploy.
Via the API
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.
Via the dashboard
To edit a gateway using the dashboard:
- Log in to the Cloudflare dashboard.
- Select your account and website.
- Go to Web3.
- On a specific gateway, click Edit.
- Update the Gateway Description and — if editing an IPFS gateway — the value for the DNSLink.
- Click Reapply.
Via the API
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.
Via the dashboard
To refresh a gateway using the dashboard:
- Log in to the Cloudflare dashboard.
- Select your account and website.
- Go to Web3.
- On a specific gateway, click the dropdown then Refresh.
Via the API
To refresh a gateway using the API, send a PATCH request with an empty request body.
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.
Via the dashboard
To delete a gateway using the dashboard:
- Log in to the Cloudflare dashboard.
- Select your account and website.
- Go to Web3.
- On a specific gateway, click the dropdown then Remove.
- Click Delete hostname.
Via the API
To delete a gateway using the API, send a DELETE request.