/register

Free subdomains for personal sites, open-source projects, and more.

Primary LanguageJavaScriptMIT LicenseMIT

🌐 Free Domains

Free subdomains for personal sites, open-source projects, and more.

Domains

📝 Register

  1. Check if your desired domain is available using our domain checker.
  2. Select a method below to show instructions on how to register a domain.
⌨️ CLI (recommended)

The CLI has 3 prefixes: domains, fd and free-domains.

  1. Install the CLI

You can install the CLI by running the following command:

npm install @free-domains/cli -g
  1. Login to the CLI

Run the following command to login to the CLI and follow the steps.

domains login
  1. Register a domain

Run the following command and follow the steps to register a subdomain.

domains register
📝 Manual
  1. Star and fork this repository.
  2. Add a new file called example.domain.dev.json in the /domains folder to register the example subdomain on the domain.dev. - An list of available domains can be found here.
  3. Edit it to meet your needs. - The file listed below is just an example, provide a valid JSON file with your needs. - Make sure to remove any records that aren't needed.
{
    "domain": "is-a-fullstack.dev",
    "subdomain": "example",

    "owner": {
        "email": "hello@example.com"
    },

    "records": {
        "A": ["1.1.1.1", "1.0.0.1"],
        "AAAA": ["2606:4700:4700::1111", "2606:4700:4700::1001"],
        "CNAME": "example.com",
        "MX": [
            {
                "priority": 10,
                "value": "mx.example.com"
            }
        ],
        "TXT": [
            {
                "name": "@",
                "value": "example_verification=1234567890"
            }
        ]
    },

    "proxied": false
}
  1. Your pull request will be reviewed and merged. - Do not ignore the pull request checklist, this is required. - Make sure to keep an eye on your pull request 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 (in most cases it takes up to 5 minutes)
  3. Enjoy your new domain!

🌐 Domains

Domains
is-a-backend.dev
is-a-frontend.dev
is-a-fullstack.dev

⚙️ Settings

All domains use the same settings.

Setting Option
DNSSEC
Email
SSL/TLS* Full
Always Use HTTPS*
HTTP Strict Transport Security (HSTS)
Minimum TLS Version* 1.0
Opportunistic Encryption, TLS 1.3*
WAF (Web Application Firewall)* Medium Security Level
Browser Integrity Check*
Caching Level, Browser Cache TTL* Standard, 4 hours

*Only available when your domain has proxied set to true.

✅ Supported Records

  • A
    • e.g: 1.1.1.1
  • AAAA
    • e.g: 2606:4700:4700::1111
  • CNAME
    • e.g: example.com
    • CNAME records cannot be used in conjunction with any other record type.
  • MX
    • e.g: mx.example.com
  • TXT
    • e.g: hello world