Add a custom domain

Learn what a custom domain is and how to set it up for your space.

What is a custom domain?

Custom domain is a unique branded domain name which you can use for your space instead of using the default CyberSpace's URL. The displayed website is exatly the same, the only difference being the address you can see in the browser. Have a look at the example below:

CyberSpace URL: https://space.cybercrowd.org/#/balancer.eth

Custom domain: https://vote.balancer.fi/#/

As you already have a domain with ENS, adding a custom domain is optional.

Add a custom domain to your space

You cannot create a custom domain through CyberSpace. Make sure that you own the custom domain before setting it up.

1. Fork the snapshot-spaces repository

Create a fork of the snapshot-spaces Github repository:

GitHub - snapshot-labs-archived/snapshot-spacesGitHub

2. Add your custom domain to domains.json

Follow the CyberSpace spaces directory tree and open the domains.json file.

└── spaces
    └── domains.json

Add the mapping for your custom domain and CyberSpace space in the following format:

"my.custom.url": "my-space.eth"

To prevent conflicts, it is recommended to add your subdomain between two existing domains rather than at the end or beginning of the list, as in the example below.

{
  ...
  "other.domain.com": "ens.eth",
  "my.custom.url": "my-space.eth",
  "other.domain.com": "ens.eth",
  ...
}

3. Create a pull request

Create a Pull Request on the original snapshot-spaces repository with the above changes.

It can take the team around 72 hours to merge your Pull Request, so please be patient 🙏

Once the PR is merged you will have to wait for the release of a new version on https://space.cybercrowd.org. It can take up to a couple of days. Once the new version is released you can move on to the next step.

4. Update space settings

Head to your space settings on CyberSpace and fill in the custom domain name field. It must match the one you added in the Pull Request.

The domain name field in CyberSpace settings.

5. Configure your DNS

Update your DNS settings on the custom domain provider dashboard and set CNAME to:

cname.snapshot.org

6. Activate your domain

Once the PR is merged use the below link to activate the domain:

https://ina9pk8175.execute-api.us-west-2.amazonaws.com/dev?domain=example.com\

Replace "example.com" with your custom domain.

Note that at this step the returned message could contain warnings, this could happen if the domain DNS zone is not fully resolved yet or if you've already successfully activated your domain. The bottom line is if you've setup the CNAME record correctly you should not worry at all.

That's all! You should now be able to use the custom domain for your space 🎉\