Skip to content

🌐 Grab your own subdomain for free Follow the steps listed below to get your own subdomain!

License

Notifications You must be signed in to change notification settings

masckmaster2007/is-a.co

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

47 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation


badge-tests badge-deploy badge-domains

Free subdomains for personal sites, open-source projects, and more. Here is a list of supported domain names:

Domain name Features
⚑ *.is-a.co cf dnssec ssl

Wildcards (like *.foo.is-a.co) are supported too

Why?

First of all, I want to answer one important question - "Why are you giving out domains for free?". Because sometimes I need domains for my pet projects, and instead of buying new domains every time, I decided to buy one for everyone, and use subdomains. And why not share them with the community?

Domains settings

Option *.is-a.co
DNSSEC βœ…
Email ❌
SSL/TLS * Full
Always Use HTTPS * βœ…
HTTP Strict Transport Security (HSTS) βœ…
Minimum TLS Version * TLS 1.2
Opportunistic Encryption, TLS 1.3 * βœ…
WAF (Web Application Firewall) * βœ… (Medium Security Level)
Browser Integrity Check * βœ…
Caching Level, Browser Cache TTL * Auto, 4 hours
Crawler Hints * βœ…
HTTP/2, HTTP/2 to Origin, HTTP/3 (with QUIC) * βœ…
0-RTT Connection Resumption * βœ…
gRPC, WebSockets * βœ…
Pseudo IPv4 * Add header
IP Geolocation (HTTP header CF-IPCountry) * βœ…
Maximum Upload Size * 100 MB

* Available only when proxying ("proxy": true) is enabled

How to get one?

  1. Star and fork this repository
  2. Add a new file called <your-subdomain-name>.<root-domain>.json in the ./domains folder to register <your-subdomain-name> subdomain
  3. Edit it (below is just an example, provide a valid JSON file with your needs, the format is very strict; format you can check here):
{
  "$schema": "../schemas/domain.schema.json",
  "description": "<describe your project in this field>",
  "domain": "is-a.co",
  "subdomain": "<your subdomain name>",
  "owner": {
    "repo": "<https://URL/to/the/repository/with/subdomain/content/sources>",
    "email": "<[email protected]>"
  },
  "record": {
    "CNAME": "<cname-domain>",
    "TXT": ["list", "of", "required", "txt", "records"],
    "A": ["list", "of", "IPv4", "addresses", "like", "a", "127.0.0.1"],
    "AAAA": ["list", "of", "IPv6", "addresses", "like", "a", "::1"],
    "NS": ["list", "of", "nameservers"]
  },
  "proxy": false // disable the CF proxy, proxying is always enabled by default
}

For the more details about the format, please, check the JSON schema

  1. Your pull request will be reviewed and merged. Please, don't ignore the PR checklist. If you ignore this repository rules, your PR will be ignored too. Make sure to keep an eye on it in case we need you to make any changes!
  2. After the pull request is merged, please allow up to 24 hours for the changes to propagate (usually, it takes about 5 minutes)
  3. Enjoy your new domain!

Domains, used for illegal purposes will be removed and permanently banned. Please, provide a clear description of your resource in the PR.

If you don't know...

  • What is GitHub pages and how to set up a custom domain, read the docs here
  • The difference between A, CNAME, and other record types, the article on Wikipedia is here
Hits

About

🌐 Grab your own subdomain for free Follow the steps listed below to get your own subdomain!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%