Use Fission's name servers and we'll automate DNS and domain updates
We can take care of this for you by hosting your DNS for you. This means changing your name servers to the Fission ones. Below are guides for some DNS providers.
ns1.fission.systems
ns2.fission.systems
ns3.fission.systems
ns4.fission.systems
Once this is completed, we'll confirm it and handle any other updates needed automatically.
Go to the domain you want to host on Fission in your Namecheap admin:
Where it says "Namecheap BasicDNS", select "Custom DNS" from the drop down:
Enter in ns1.fission.systems
and ns2.fission.systems
and click the green check mark to save.
Instructions for DNS and domain registrar settings to use a custom domain with Fission
Every Fission App gets a free subdomain.
Currently, these look like YOURUSERNAME.fission.name
, but we're migrating to user accounts and attached apps, where every app has YOURAPPNAME.fission.app
.
To use a custom domain of your own, like YOURAPPDOMAIN.com
, you need to make some changes to DNS. There are two methods detailed in the following pages:
Fission Hosted DNS - move your nameservers to Fission, we automate everything
Control your own DNS - create a CNAME and TXT record and point them at Fission services
Note: custom domains currently require manual confirmation by us. This will be integrated directly into the Fission CLI and be fully automated. For now, contact us on our support page if you want to use this feature.
By using Cloudflare as your DNS provider and their IPFS gateway, you can deploy on Fission but have your content be served by Cloudflare. This will let you use custom domains with your Fission apps while we work to automate the process fully on the platform.
For your domain, YOURAPPDOMAIN.com
, go into your DNS provider control panel and add a CNAME pointing to cloudflare-ipfs.com
.
Since your domain is already hosted with Cloudflare, there's no step two: they'll add SSL support to it automatically, and turn off proxying.
Now, add a TXT record pointing to your app subdomain. Your APPNAME is created when you run fission app register
, and will look something like junior-angular-tulip
. We're creating a link to say that the content from that app should be served up at your domain with a special dnslink record:
That's it, you're done!
Whenever you publish a new version of your Fission app, we update the hash that this special record points to. When you go to YOURAPPDOMAIN.com
, Cloudflare's gateway looks up this _dnslink
record, checks the ipns record, gets the hash, and fetches the content from the global IPFS network. This might even be from your computer directly.
When we initially tested this, the Cloudflare gateway was caching for up to 6 hours. It seems to only take a few minutes at most to show updated content now, but it won't be instant like using Fission directly.
Record
Type
Value
_dnslink
TXT
dnslink=/ipns/APPNAME.fission.app
Record
Type
Value
@
CNAME
cloudflare-ipfs.com
Use a custom domain with Fission and keep control of your DNS
By adding a TXT record for your app and a CNAME pointing at our gateway, you can run your DNS elsewhere but still have a custom domain for your Fission app.
For your domain, YOURAPPDOMAIN.com
, go into your DNS provider control panel and add a CNAME pointing to ipfs.runfission.com
.
@ usually represents the "root" or domain apex. Some DNS providers don't support a CNAME for your root, so you'll need to add a CNAME for www
instead.
The process for a subdomain is the same SUB.YOURAPPDOMAIN.com
, but looks a little different. Go into your DNS provider control panel and add a CNAME pointing to ipfs.runfission.com
.
Next, add a TXT record pointing to your app subdomain. Your APPNAME is created when you run fission app register
, and will look something like junior-angular-tulip
. We're creating a link to say that the content from your app should be served up your domain with a special dnslink record:
Subdomains function the same way, with the _dnslink subdomain, where you're adding the TXT record being "above" the SUB.YOURDOMAIN.com record, which looks like this:
This process is not fully automated right now, so you'll need to send us an email support@fission.codes
or drop by our support page to send us a chat, and we can get things setup on our end.
Record
Type
Value
@ (root)
CNAME
ipfs.runfission.com
Record
Type
Value
SUB
CNAME
ipfs.runfission.com
Record
Type
Value
_dnslink
TXT
dnslink=/ipns/APPNAME.fission.app
Record
Type
Value
_dnslink.SUB
TXT
dnslink=/ipns/APPNAME.fission.app