Adding a Custom Domain

This guide will walk you through the process of adding a custom domain name to your dedicated IPFS gateway using a CNAME record. By setting up a custom domain, you can personalize your IPFS gateway URL and make it easier for users to access your content.

Prerequisites

• You must have a registered domain name.

• Access to your domain's DNS management settings.

• A dedicated IPFS gateway set up on Filebase.

Step-by-Step Guide

1. Navigate to the Gateways page in your dashboard.

2. Select the Options menu for a gateway, then select Add Custom Domain

   
3. Create a CNAME Record

   In the DNS settings for your domain, you will create a CNAME record that points your custom domain to your dedicated IPFS gateway.

   1. Add a New CNAME Record:

      • Name/Host/Alias: Enter the subdomain you want to use. For example, if you want to use ipfs.domain.com, enter ipfs.

      • Type: Select CNAME.

      • Value/Target/Destination: Enter the URL of your dedicated IPFS gateway. This should be the URL you copied in Step 2 (e.g., your-gateway.myfilebase.com).

      • TTL: You can typically leave this as the default value.

   2. Save Changes: Save the new CNAME record.

4. On the Add Custom Domain dialog, type in your custom domain, then click Add Custom Domain. Be sure to perform this step only after completing Step 3 first. Filebase will verify the DNS configuration, provision a TLS certificate, and begin hosting your domain.

   

After the above steps have been completed, your gateway should now be accessible using the following URL format:

https://ipfs.domain.com/ipfs/<cid>