myaddr.tools

A minimalist dynamic DNS service

Features

No ads, no tracking, no nonsense
Get a subdomain name in seconds, no account required
Easy, forgiving HTTP-based API
ACME dns-01 challenge support for TLS certificates from CAs like Let's Encrypt
Suffixes added to the Public Suffix List
Multiple domains (all resolve the same):
- your-name.myaddr.tools
- your-name.myaddr.dev (on the HSTS preload list)
- your-name.myaddr.io
- and all subdomains of above

Getting Started

First, claim your name. If the name is available, you will be given a secret key.

This secret key gives whoever holds it control over that name. If you lose the secret key, you lose the name.

With your secret key, you can call the Update API to manage your DNS records.

Update API

Manage DNS records

URL: https://myaddr.tools/update

The /update endpoint is forgiving, meaning it:

treats GET, POST, and PUT requests as equivalent update requests
reads parameters from the URL query string and from POST and PUT bodies
POST and PUT bodies can be application/x-www-form-urlencoded or application/json
responds with body OK and status code 200 on success
responds with a helpful error message and 4xx otherwise

Add or Update an IP Address

To add or update an IP address, send a GET, POST, or PUT request to /update. Specify key and ip parameters.

Set ip to any valid IPv4 or IPv6 address, or set ip=self to use the requester's IP address. Use host ipv4.myaddr.tools or ipv6.myaddr.tools to force IPv4 or IPv6.

Adding an IPv4 address will replace any existing IPv4 address, and similar for IPv6.

Add an ACME Challenge

To add an ACME dns-01 challenge, send a GET, POST, or PUT request to /update. Specify key and acme_challenge parameters.

The acme_challenge value will be served as a TXT record on all _acme-challenge subdomains. Challenge TXT records are automatically removed after a few minutes.

Delete an IP Address

A DELETE request to /update with key removes both IPv4 and IPv6 addresses. Always responds with status code 204.

Registration API

Manage your registration

URL: https://myaddr.tools/reg

Delete your Registration

To immediately and permanently delete your registration and release your name, send a DELETE request to /reg. Specify key.

Things to Know

You must update each IP address (IPv4 and IPv6) at least once every 90 days for that IP to remain active.
IPv4 and IPv6 updates are tracked independently.
If no updates are made to your name for 120 days, your registration is deleted and your name released.

Acceptable Use

Users of this service will not engage in distributing malware, abusively operating botnets, phishing, piracy, trademark or copyright infringement, fraudulent or deceptive practices, counterfeiting, or otherwise engaging in activity contrary to applicable law. Such behavior may lead to the deactivation of the subdomain.

Please send reports of unacceptable use to .

Privacy Policy

No personal data is collected.