Docs / Guides / URL redirect

URL redirect

A short link at your own name. No hosting, no DNS, nothing to deploy.

What you'll end up with

Visiting you.runs-on.dev sends the browser to any absolute http:// or https:// URL you choose, a project page, a GitHub profile, a link-in-bio, anything. The redirect is served by the app itself, not DNS.

The record

domains/you.json

"records": { "URL": "https://github.com/you" }

URL must be the only key under records. It cannot sit next to a CNAME, A, TXT, or MX record, and it is not allowed inside subdomains at all, since the app only ever looks up the claimed name itself.

Steps

  1. Fork the registry.
  2. Edit domains/you.json, setting records to the block above with your own target URL.
  3. Open a pull request against main.
  4. CI validates the URL is absolute and uses http: or https: (javascript:, data:, and protocol-relative URLs are rejected). Once green and merged, the redirect takes effect within the page's 30-second cache window.

How to tell it worked

Visit https://you.runs-on.dev. It should redirect (HTTP 307) to your target URL within a few seconds of the pull request merging.