System-End/dns
1
0
Fork 0
mirror of https://github.com/System-End/dns.git synced 2026-04-19 22:05:14 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
🕹 Manage Hack Club's DNS through a GitHub repository
2360 commits 1 branch 0 tags 2.7 MiB
Find a file
Zach Latta f507125e6f Remove unused test files 
- Delete bin/test-dry-run script
- Delete config/test.yaml configuration

These test files are no longer needed after successful Cloudflare proxy deployment.

Co-authored-by: Amp <amp@ampcode.com>
Amp-Thread-ID: https://ampcode.com/threads/T-e7a32ea5-66e7-45a8-93fc-e12a629c3ec4
2025-09-06 18:25:27 -04:00
.github fix: GitHub Actions test workflow for Cloudflare-only testing 2025-09-06 18:25:27 -04:00
bin Remove unused test files 2025-09-06 18:25:27 -04:00
config Remove unused test files 2025-09-06 18:25:27 -04:00
.gitattributes Mark YAML files as Linguist-detectable (#632) 2021-12-17 09:37:59 -08:00
.gitignore Prepare to make Cloudflare changes live 2025-09-06 18:25:27 -04:00
aisafety.dance.yaml Also update top record for aisafety.dance (#1145) 2024-04-29 11:34:31 -04:00
bank.engineering.yaml Update bank.engineering.yaml 2025-01-23 21:14:16 -05:00
bulckcah.com.yaml proxy.servers.hackclub.com -> proxyparty.hackclub.com 2021-11-23 16:16:19 -05:00
cpu.land.yaml Add cpu.land and aisafety.dance 2023-07-24 10:54:34 -04:00
dino.icu.yaml Prepare to make Cloudflare changes live 2025-09-06 18:25:27 -04:00
dinosaurbbq.org.yaml Add aux.dinosaurbbq.org (#1100) 2024-03-02 21:23:44 -06:00
hack.af.yaml Prepare to make Cloudflare changes live 2025-09-06 18:25:27 -04:00
hack.club.yaml Fix gh proxy (#1980) 2025-08-25 14:16:38 -04:00
hackclub.app.yaml Add TXT record for the PSL (#1981) 2025-08-27 14:52:35 -05:00
hackclub.com.yaml Prepare to make Cloudflare changes live 2025-09-06 18:25:27 -04:00
hackclub.dev.md Document hackclub.dev! 2023-01-18 16:07:56 -05:00
hackclub.io.yaml Add proxytest.hackclub.io 2023-08-31 15:07:45 -04:00
hackclub.org.yaml Set correct DKIM key 2024-02-20 10:53:04 -05:00
hackedu.us.yaml proxy.servers.hackclub.com -> proxyparty.hackclub.com 2021-11-23 16:16:19 -05:00
hackfoundation.org.yaml Add the.hackfoundation.org 2021-09-30 13:32:55 -04:00
nonprofit.new.yaml Update nonprofit.new.yaml (#1644) 2025-03-29 09:02:47 +00:00
README.md Update README.md subdomain policy (#1846) 2025-07-10 08:40:06 -05:00
scrap.dev.yaml Use ALIAS for root domain 2023-02-23 11:07:48 -05:00
scrapbook.dev.yaml Use ALIAS for root domain 2023-02-23 11:07:33 -05:00
wackclub.com.yaml Adding waka.wackclub.com (#1412) 2024-11-07 19:01:25 -06:00

README.md

Hack Club's DNS

test deploy

This repository is used for managing Hack Club's DNS configuration through OctoDNS. Please see its documentation for more information.

Adding a subdomain

  1. Create a fork of this repository.
  2. In your fork open the hackclub.com.yaml file and add the following alphabetically based off the subdomain name:
SUBDOMAIN_NAME:
  - ttl: 600
    type: CNAME
    value: SOURCE_DOMAIN_OR_IP.
  1. Replace SUBDOMAIN_NAME with the name of the sub-domain. So if the name was hello then the subdomain would be hello.hackclub.com.
  2. Replace SOURCE_DOMAIN_OR_IP with the domain or IP address of the website you want the subdomain to go. If you are using an IP address change type: CNAME to type: A. Remember to leave that . at the end!
  3. Commit your changes and create the PR!

That's it! Someone with contributor access to the repo will then review your PR.

If you're asked to make any changes to your pull request, please amend it by commiting to your fork, instead of closing it and creating another.

Replacing a CNAME record with another record type

The CNAME record cannot coexist with other record types, which may require you to change to an ALIAS or A record type if you need additional DNS records on your subdomain. Due to a bug in OctoDNS, removing a CNAME may result in deploying your changes breaking. You might encounter this when trying to use both Vercel and email/Google Workspace on the same subdomain.

To fix this, follow these steps, each in a seperate PR:

  1. Make a PR that deletes all records on your subdomain (ex: #1642).
  2. Make another PR that adds the additional records needed, replacing the CNAME with the other record that you want (oftentimes ALIAS) (ex: #1643).
  3. Make it clear to the person reviewing your PRs that the first PR must be merged before the second one.

Limitations

Subdomains, under domains following the format hackclub.xxx(or other domains reffering to hackclub), are only available for official Hack Club projects, not including HCB (fiscally sponsored) projects. Everyone is welcome to use dino.icu!

When adding a site hosted on ▲ Vercel, you will need to verifiy the domain by adding a TXT record.

image

Add the value to the hackclub.com.yaml file as shown below:

_vercel:
  ttl: 600
  type: TXT
  values:
    - vc-domain-verify=wackclub.hackclub.com,423c28e0fbdd51449cf1