myaddr.{tools,dev,io}

A minimalist dynamic DNS service

Features

• No ads, no tracking, no nonsense
• Get a name in seconds, no account required
• Easy, forgiving HTTP-based API
• 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
• ACME dns-01 challenge support for TLS certificates from CAs like Let's Encrypt

Getting Started

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

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

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

API

Update

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 IP Addresses

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

Registration

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.

Privacy Policy

No personal data is collected.

Contact

Please send reports of malicious use of this service to .

Powered by addr.tools