Get started with OmniDNS

Three steps from zero to a live dynamic record.

Step 1 — Create a record

Pick your zone and add the subdomain that will follow your IP.

[ OPEN RECORDS ]

Save the update token — it is shown once and works like a password.

Step 2 — Point an updater at it

Any DDNS client (or scheduled task) can call:

/api/v1/update?hostname=<subdomain>&token=<update-token>&ip=<optional-ip>

Omit ip to use the caller address. Prefer the tunnel agent for always-on hosts.

Step 3 — Verify

Records reporting within the last 10 minutes show live on the records page.

[ OPEN DASHBOARD ]

An unhandled error has occurred. Reload 🗙

> RE-ESTABLISHING UPLINK TO SERVER...

> UPLINK FAILED. RETRYING IN SECONDS.

> FATAL: UPLINK TERMINATED.
> PLEASE RETRY OR RELOAD TERMINAL.

> SESSION SUSPENDED BY HOST.

> RESUME FAILURE.
> PLEASE RETRY OR RELOAD TERMINAL.