runs-at.dev
runs-at.dev // documentation

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-at.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

Note

Two ways to apply this. The quickest is runs-at.dev/manage: sign in, pick the record type, paste the value, save. It writes the same commit to the registry and DNS follows within seconds. The steps below do it by pull request instead, which is what you want if you would rather review the change first. Either way handles subdomains entries.

  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-at.dev. It should redirect (HTTP 307) to your target URL within a few seconds of the pull request merging.