joosh's Domain Tutorial!!!

The Nekoweb official instructions can be confusing and I see a lot of people in the Discord asking about this.

!!! I've seen lots of issues with custom domains using Squarespace. I suggest switching your nameserver to Cloudflare. It is free and there is a tutorial here.

This is my personal tutorial for all you Nekowebians out there! I would recommend watching the video at the bottom for a more thorough guide.

Setup

1. Donate to Nekoweb to unlock custom domains.
2. Purchase a custom domain from a site like Porkbun.
3. Go to Nekoweb settings and under the Add domain section, type in your new domain, eg. joo.sh
4. Leave the folder blank if your site is located in the root.
5. Select main if this is what you want your main domain to be. Your main domain is where your [username].nekoweb.org link will route to.
6. Click add.
7. Go to the DNS settings in your registrar.


8. For Porkbun:
   1. Click on your account dropdown and select Domain Management.
   2. Hover over your domain and a DNS link will appear.
   3. Click the DNS link and it will open the Manage DNS Records popup.
   4. For Type, select ALIAS - CNAME flattening record.
   5. For Host, leave it blank for the root.
   6. For Answer / Value, set it to dns.nekoweb.org.
   7. Leave TTL as the default value.
   8. Click add.


9. For namecheap:
   1. Go to the dashboard from the dropdown menu on your username.
   2. Click Domain List on the left side.
   3. Click the MANAGE button along the right side of your domain.
   4. In the navigation bar, click Advanced DNS.
   5. Delete the two default host records.
   6. Click the red ADD NEW RECORD button.
   7. For Type, select ALIAS Record.
      • CNAME will NOT work as the type. Make sure you use ALIAS
   8. For Host, type @ for the root.
   9. For Value, set it to dns.nekoweb.org.
   10. Leave the TTL to Automatic.
   11. Click save.


10. For Cloudflare:
    1. Go to the DNS settings and add a record.
    2. For Type, select CNAME.
    3. For Name, type @ for the root.
    4. For Target, set it to dns.nekoweb.org.
    5. Click save.


11. View the status in the Nekoweb settings to confirm it worked.
12. Done! Just wait for it to propagate and it'll be ready to go.

Common Porkbun Errors

• Answer must be IPv4 Address

  Make sure you are selecting an ALIAS record.



• Another record type already exists for that host.

  Delete any other DNS records. If you have pixie.porkbun.com, you do not need it.

Common namecheap Errors

• Please provide a valid IP address.

  Make sure you are selecting an ALIAS record.

Sorry if you don't use either of these services, it's all I've used and it's all I can help with. If your custom domain continues to not work after a few hours, contact us in the discord!

I also made a video in case you want to see what I am doing. I also go over setting subdomains!