joosh's Domain Tutorial

Nekoweb recently released true multiple site support, and with it came a change to the custom domain setup process. This tutorial should cover everything you need to get your custom domains ready to go on Nekoweb!


Table of Contents


Before you start...

You are going to need to buy a custom domain.

I recommend purchasing a custom domain from a site like Porkbun. There are alternative options, but this one tends to be the easiest (and often cheapest).


Custom domains can only be used by Nekoweb Donators. If you are not currently one, you can do so here!


Initial Nekoweb Setup

  1. Go to Nekoweb settings and right underneath Create a new site text, use the textbox to enter in the domain you just purchased, eg. joo.sh
  2. Once you click the Create site, it will redirect you to the domain settings page for that new site. There is nothing else needed on this page.
  3. Go to your nekoweb dashboard and create a folder in the root of the same name as your domain. Eg. joo.sh
  4. Put all the files needed for your new site in this folder.
  5. Continue to DNS Setup.

DNS Setup

Cloudflare Setup - Recommended Method!

If you are using a different registrar than Porkbun or namecheap then I HIGHLY recommend switching nameservers to Cloudflare.

Using Cloudflare will require a few extra setup steps. It is free to do so and there is an official tutorial here. Once you are finished switching name servers, you can continue to the DNS steps below.


  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.

One important note about Cloudflare is its server-side caching. You may be editing your site and notice changes aren't appearing even after clearing your local cache. To fix this, go to the Overview page for your domain on Cloudflare and enable Development Mode found on the right side.


Porkbun Setup

  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.

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.


namecheap Setup

  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.

Common namecheap Errors

  • Please provide a valid IP address.

    Make sure you are selecting an ALIAS record.


Final Nekoweb Setup

We are going to check the domain status in Nekoweb now to make sure everything in the previous steps worked.


  1. Go back to the Nekoweb Settings page.
  2. Click in to the settings for the new site you created.
  3. Navigate to the Domain tab.
  4. Scroll down until you see Domain status.
  5. The status should say Domain is connected to network and working. If it does, congrats, you're good to skip to the next steps!
    • You may also see a blue code with the text saying Domain is connected to network, but SSL is not working. Don't fret about this, just come back in a little bit and it should update to the green message.
    • If the status says Domain is not connected to network, double check your DNS settings for any typos or errors.
      • After checking for any errors, you may go back the Domain settings and click the Reverify button.
  6. Wait for your new domain to finish propagating!
  7. Enjoy your new domain!

Subdomains

Subdomains are a little different after the Nekoweb update. You can no longer nest files for your subdomains in other site folders, meaning you will need the files for your subdomain in the root of your Nekoweb dashboard.


  1. Go to your Nekoweb dashboard and create a new folder for your subdomain in the root INCLUDING THE FULL DOMAIN, eg. plasma.joo.sh
  2. Follow the the steps for the initial Nekoweb setup again, but this time using your subdomain as your new site.
  3. Follow the DNS setup steps again.

    • Cloudflare
      • Same steps as previously, except set Name to just your subdomain, eg plasma. You do NOT need to do the full URL, just whatever your subdomain will be!

    • Porkbun and namecheap
      • Same steps as previously, except set Host to just your subdomain, eg plasma. You do NOT need to do the full URL, just whatever your subdomain will be!

Updated August 5th, 2025