Free is-open-source.org Subdomain

How it works

How to request a subdomain

1. Fork this repository.
2. Create a new JSON file inside the domains/ folder.
3. Name your file something like yourproject.json.
4. Use this example template:

{
  "subdomain": "example",
  "owner": {
    "repo": "https://github.com/yourgithubusername/reponame",
    "email": "example@example.com",
    "name": "Your Name"
  },
  "record": {
    "CNAME": "yourhosting.com"
  }
}

If you use an IP address instead of a domain, you can also use an A record like this:

{
  "subdomain": "example",
  "owner": {
    "repo": "https://github.com/yourgithubusername/reponame",
    "email": "example@example.com",
    "name": "Your Name"
  },
  "record": {
    "A": ["1.2.3.4"]
  }
}

Rules

Your project must have 5+ hours on [Hackatime!](https://hackatime.hackclub.com/)
• Your project must be open-source.
• Your repo should have a proper README and description.
• Don't request silly, spam, or unrelated subdomains.
• Your website must accept your subdomain (if using CNAME).
• We manually review each request (no auto-approval).

What happens after you submit?

• Your Pull Request will be reviewed.
• If accepted, it will be merged.
• Your DNS record will be updated automatically!
• It can take a few minutes to 1 hour to be live.

Need help?

Open an Issue or contact us via email:

That's it! Welcome to the is-open-source.org family!