Guide & Frequently Asked Questions

To add a new hostname, follow these steps:

• Go to Hostname Management from the main menu
• Click the Add new hostname button
• Fill in all the information:
  • Hostname: The name you want (letters, numbers and hyphens only)
  • Domain: Choose an available domain
  • IP Address: Your current IP (auto-detected)
• Click Add record to complete

Note: Hostname can only contain letters, numbers and hyphens. Cannot start or end with a hyphen.

To change your account password, do the following:

• Go to Profile from the main menu
• Find the Change Password section
• Click Send verification code
• Check your email for the 6-digit verification code
• Enter the verification code and new password
• Confirm password and click Update

Note: Verification code is valid for 10 minutes. New password must be at least 6 characters.

The system uses the following statuses to display hostname condition:

• 🟢 Online: Hostname is working normally and accessible
• 🔴 Offline: Hostname hasn't updated IP for a long time or is not accessible
• ⚪ Inactive: Hostname has never been updated or was just created
• 🟡 Updating: Hostname is currently in the process of DNS update

Status is updated automatically based on last update time and ping test results.

The system supports multiple IP update methods to suit your needs:

 1. Update via DynDNS API (Compatible)

Use DynDNS/No-IP compatible protocol to update via router or client:

• API URL: https://mayddns.com/nic/update
• Method: GET with Basic Authentication
• Parameters:
  • hostname: Full hostname name (e.g: example.mayddns.com)
  • myip: IPv4 address (auto-detect if not provided)
  • myipv6: IPv6 address (Pro+ plans only)
• Authentication: Username and Password from hostname details

Example:

curl -u "username:password" "https://mayddns.com/nic/update?hostname=example.mayddns.com&myip=1.2.3.4"

 2. Update via direct URL (No authentication required)

Use unique URL from hostname details for simple updates:

• IPv4 Update URL: https://mayddns.com/update/{uuid}
• IPv6 Update URL: https://v6.mayddns.com/update/{uuid}
• Auto-detect IP: Get IP from client headers or parameter
• Secure: Unique UUID, cannot be guessed

How to get URL:

• Go to Hostname details from hostname list
• Copy URL from "Update IPv4 URL" or "Update IPv6 URL" section
• Use that URL in scripts or cron jobs

Usage examples:

curl "https://mayddns.com/update/6f5fa996-daac-4070-9650-64fd30dcbe74"

wget -q -O- "https://v6.mayddns.com/update/6f5fa996-daac-4070-9650-64fd30dcbe74"

 3. Automatic methods

• Router/Modem: Configure DDNS with API information
• Linux Cron job: */5 * * * * curl "YOUR_UPDATE_URL"
• Windows Task: Scheduled task running periodic script
• Docker/K8s: CronJob or sidecar container

Response codes: good (success), nochg (no change), badip (bad IP), badauth (auth error)

The system provides service plans suitable for different needs:

• FREE: 5 hostnames, TTL 1200s, IPv4 only, no support
• PRO: 50 hostnames, TTL 600s, IPv4 & IPv6, chat & email support
• BUSINESS: 300 hostnames, TTL 600s, IPv4 & IPv6, custom domain, priority support
• SELF-HOSTED: Unlimited, full control, API, AnyDesk support

All paid plans have a 1-year term and are automatically renewed.

If you need support, please contact us through the following channels:

• Email: support@mayddns.com
• Live chat: Use the chat widget in the bottom right corner
• Technical support: For BUSINESS and SELF-HOSTED plans

Response times:

• FREE plan: 24-48 hours
• PRO plan: 12-24 hours
• BUSINESS plan: 2-6 hours
• SELF-HOSTED plan: 1-2 hours (with AnyDesk support)