Apply for a Subdomain

Application Steps

1. Fork the registry repository
   Visit the DevSpace registry repository on GitHub and fork it to your account.
2. Add your JSON configuration file
   Create a new JSON file in the appropriate directory with your subdomain details.
3. Open a Pull Request
   Submit your changes as a Pull Request for manual review and approval.

JSON Format

Create a JSON file with your desired username. The filename should match your username (e.g., alex.json).

{
  "domain": "yourname",
  "owner": {
    "github": "yourusername",
    "email": "your@email.com"
  },
  "record": {
    "type": "CNAME",
    "value": "yourusername.github.io"
  }
}

Field Descriptions

• domain — The requested subdomain label. For example, "alex" becomes alex.devspace.qzz.io.
• owner.github — GitHub username of the domain owner. Used for verification and contact.
• owner.email — Contact email address of the domain owner.
• record.type — DNS record type. Must be "CNAME". No other record types are allowed.
• record.value — The approved hosting target (e.g., alex.github.io, yourproject.vercel.app).

Vercel Example

If you're hosting on Vercel, your configuration would look like this:

{
  "domain": "myproject",
  "owner": {
    "github": "developer",
    "email": "dev@example.com"
  },
  "record": {
    "type": "CNAME",
    "value": "cname.vercel-dns.com"
  }
}

Before You Apply

Make sure you have:

• A live site hosted on GitHub Pages or Vercel or Netlify or Cloudflare Pages or Firebase Hosting
• A public repository (for GitHub Pages)
• Custom domain configured in your hosting settings
• Read and understood the Rules

Ready to Apply?

Click the button below to visit the registry repository and start your application.

Processing Time

All applications are manually reviewed. Please allow a few days for your request to be processed. You will receive updates via the Pull Request discussion.